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Pafft 1 

Begttjg l- Whj Implement IQCCHnLtSF 


LISP has proved itssli to be a powerful language For representing comple* 
informatiO-n processing tasks, This power stems from: 

1. The uniform reer'esentalionbl programs and dal*. 

2. The ability Id build arbitrarily camples cal a structures in th* few n* of s-expressiorts, 

3. Recursion. 

Power, however, it not necessarily B™l pedagogy. LOGO it a computer language 
designed especially for the beginner. Itt purpose It to introduce the fundamental ideas 
of computation a>5 clearly ps possible. 

LISP LOGO it an implement il ion or LOGO in USP. It hat been designed tor several 
reason;. The first is (fiat these two languages share a fundanenliF core In common. 
Both are time shared, interpretive languages capable of full recursion. Variable and 
procedure names may be any string of letters and digits. 5ub"Procedure definitions are 
independent ol super-procedures. Both isumarical and list'struclurid information can be 
manipulated with equal facility. Thus, the LOGO systems programmer is Ireed of the 
necessity of re-developing various facilities already available irt LlSP flists, recursion, 
garbage coflcctio-n, error service traps, interrupts). He can concentrate On additions 
(better error analysis? and modifications (pedagogical simplifications) to LISP. LLOEjO 
unifies language development across a broad spectrum ringing IrOm PLANNER and 
CqNNlVER through LISP to LOGO. 

A second reason fpr this implementation is (P provide a mica a* transition to the 
more powerful computational world of USP as Ihp studenf grows more sophisticated. 
Whan desired, the student bis access to til of Ihe capabilities of USP including: 

Arrays 

Functions ol arbitrary number ol inputs 

functions that do nOl evaluate their inpuls 

WORO-Pl ANNER and CONNIVED 

Interrupts 

LISP compiler 

Property lists 

Floating point numbers 

Character display cursor manipulation 

Ini in ite precision fixed point arithmellc 
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Section 2. Difference* bttwten LOGO and LIS? 


! 'in differences t-eVween LOGO and USP can be described On the basis ol three 
educational 1 goals: 

Simplicity of b&tb th* compulstional *iyj isrplmatory kind, 

N»tur*lry;si whe*ein tbs Overhead For a naive user ie minimi ted by Allowing 

standard English convention*. 

Disparity which emphas'zes the drsti ration between various modes such as 

delimng versus running program*. 

It should be holed, however, that there can be no one unique solution to I he 
T>esT" cdtKaliCmal language; These three goals ten cOnFlict. Furthermore, Ihey cannot be 
so emphasized thal impottanl ideas of computation are completely eliminated from the 
language. For students OF dilferent backgrounds, simplicity and naturalness may have 
very dflferent meanings. Hence, alter natives to the partiedter chorees made h designing 
CLOGO end J (LOGO are also described. This section may be viewed as presenting a 
spectrum OF pOs-sib Hites from which a teacher can build a computational world tailored to 
his own pedagogical purposes, 


2 1 Simplicity 
Lisle wSrsiH Sentences 

Lists have a simple recursive definition, A Hst Is either 

1, Wfi, the empty list 

2, {word L words , , , a sequence qf words ■(« atoms] 1 

3, A list of lists. 

This definition is confusing when the student is still having trouble with the concept or 
recursion. CLOGO I nits itself Id fists built From only the First two cl thesis three clauses. 
SL*h lists are called "sentences’';. 

Alternative view: the concept Of recursion is loo important lo be eliminated 
From LOGO- Recursive programs are allowed. Educationally, the more examples 
Of recursion available, the easier it is to understand, hence, lists should be 
allowed. 

Computational- power it not always In conllitt with educational simplicity. Ih 
addition 10- the standard list operalians oF FIRST and JF bTFIRST fCJQIF], LOGO 

provides MST and BUTLAST. Furthermore, all four OF these Operations work on words 
as well as sentences. The fad that word manipulation is more costly than list 
manipulation far USP t or that taking, the IdST'of $ list Is more expensive than computing 
its FfRST Is not of interest [O' the beginner. The natural symmelry of having all OF these 
Operations is to be preferred. 

Alternative view; LOGO Introduces two data types - words arid sentences. 
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There is both an empty word end an empty sentence. LL$P’s world is easier to 
understand. There \% only one typo oi data, s-esrpressiOt**. Primitives like Ctf-R 
are hit operations only; they do not operate on words by manipuiat n@ the 
word 1 ?, crint name, is LOGO'S FIRST does. 

Repeatedly flLTF.FfiSJ'ing a sentence rn LO®> always terminates in the empty list, 
to LISP, wilh its more general list structure built from "dotted pairs" and t'OiVSing, this is 
not always so. The result is the possibility of "slip-through" bugs Cor EMPTYP endlests 
of recur tive procedure*. Thus, LOGO eliminates i common source Oi error without 
significantly limiting computational power. 

Alternative view; Allowing an ttom to be the CDS of ar» s-expression 
sometimes allows lor economy of storage. Also, the syrruelry of CAR and COR 
in LISP make the data structure easier to exp’am, although they are symmetric 
as List operations only lor the particular representation oi I - si? used in LSSP. 

Rigid- program form 

LISP allows programs to he lists of any form. Editing, and debugging consequently 
become awkward due to the difficulty in naming parts of the program. LOGO simplifies 
program structure by requiring that a program be a series of numbered tines. The 
locations of bugs and intended edils are then far easier to describe. 

Criticism; LOGO violates this assumption by allowing the user to create lines of 
unlimited complexity. II would be preferable to liimt a line to a single too level 
call This does not prohibit nesting, a Fundamental idei in compulation-, EM il 
does prohibit defeating the entire poml of line numbers with such code as- 

>10 FD m FT W Ft> 1W fiT 1 M . ... 

An alter native scheme might be Id adopt a "POT* like convention, Lines are 
identified by offsets from user “defined location symbols. This has thi 
advantage OF encouraging the use of mnemonic names for portions of the User's 
program, rathor than line numbers, which have no mnemonic value, while 
retaining, the virtue of having a name For every part of Ihe program. The user 
would not have to renumber lines it he wanted to Insert more lines, between 
two lines oi code than the difference between their tine numbers. 

Integer Arithmetic 

The initial CLQGQ world limits (he user to integer arithmetic. The rationale behind 
this IS to avoid the complexity of decimal fraction*, Tlet |* clearly a Simplification whose 
value depends on the background of the students. 

Criticism-; even for element try school children, this simplification may cause 
confusion. Mosl beginners arc troubled with 
1 

— - 0 
2 

Pro-pcmenls of lined point arithmetic might reply that this is no,worse than 

l 

— -.9*9999 
1 
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However, a decimal printer b* devpr |n perlor-tnirii roundoff, 

Other alter natives are to limit *rithrn*tic to ration*! number *, or to gs* the 
following LISP cOnvonl'Orl; Number* are fixed point unless ending in a dedmal 
fraction, Operation* only return Filed point it both operands are fixed point. 

Another virtue ot USP «* |h*t fitted point numbers tan be infinitely targe. 
Arbitrary limitations due to the finite size Of the corr outer's word do not exist to contuse 
the beginner, 

Conditionals 

LOGO B lows 1 ha following typo 0 J branching; 

>t(J TEST * predicate* 

>20 if TRUK 
>30 1 FFAISF rt *, 

TEST sets * flag which subsequent {FTftlJE'i ard iFFAISITi. access. This avoids the 
necessity oF the entire conditional appearing on a single- line of the procedure. The 
student has explicit names in tha torn of fine numbers For each branch. 

Criticism; This prevents nesting of cunditioivBls, A second conditional wipes Out 
the results ot the first. In LUXSQt the Flag sal by TEST is simply a UfiP 
variable. 'Since it is global, ’Tf^'Ts in sub-prOcedures can affect tFTRUFt In 
the super -procedure. This introduces • non-local nature to control structure. 

LOGO'S lack of canned loops such as GO and MAFC/1H can be Gfiticizod as 
encouraging. bad programming practice, such is excessive use dF CO. This obscures the 
logical structure oF programs. Also 1 , it may be significantly confusing to the beginner, and 
the source of many bugs. A child might understand quite welt a controF structure concept 
like "do this part of the program three; tim*?”, Or xle this part of the program tor oath 
tie men! of the list' but may be unable to open code I ha I control structure in terms ot 
pumps and cOnditrenals, LOGO programs can't b* "pretty printed" to ro^eal (heir logical 
str-ucfuire as can programs written in LISP or a block structured fenguage. 


g.g Naturalness 


Mnemonic Names 

An obvious virtue of any computer language i* to use procedure names whose 
Efngl'sh meaning suggests ihei r purpose. Consequently, LISP's primitives C/lfT and CDR 
are renamed FIRST end m/TFIllST. 

Note; Everyone remembers hpw yn-mnempnie CAR and CDF ire. However, 
most LISP primitives ere named afler their English counterparts. 

CLOGO syntax alfews. the use Ot certain "npipg words*, words which appear in the 
user's code, but have no effect beyond making She code read more like Erglish sentences. 
For oxempfe, In fhp following fines of LOGO code, the /I,Mil, OR, THEN, and TO **$ 
permitted but serve nO computational purpose. They do no I des gnate procedures, as is 
the usual case with words not beginning with a colon. 
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?8QTH i> AND 

?fi 'iTMEti tpvydicisle j> (Jfi SpneJicufa J> 

VF < P re4ite \la f> THEN .. . 

?GO TKJ ♦. *., 


However, as the student gains more insight inter LOGO, nds* words became a 
burden. They cbnplicale the task el the parser, preventing the student from tooling Ihil 
he rea f 4y understands lha language. Mott Crf the ndse wO*di Kj|v( been eliminated 1 in 
both PPP11 LOGO and LJSP LQGft [LLOGG will Id^rate TURN in conditionals, and TO in 
transfers, however, because they ere so commonly used.] 

Matchlra English vocabulary Id computer function C*n be difficult. English words 
rarely have a single raining, Following are same examples where CLOGO may have made 
the yronj choice. 

1. CLQQO uses tS instead ol EQUAL for its equality predicate. The rationale is th*l IS 
will be mflre famlliif to a non-mathematical begi™i*e, Mpw#v«r, the omnipresent nature 
of this English verb results in such LOGO code *S: 

tTEST tS iTftlS.NVf4BER CRRATRRP tTHATMMBKR 

thus, it might be belter ter LOGO lb us* E0G'£L- 

2, Another example where LOGO fitly have chosen the wrong word is in doming 
procedures. This it done vl« 


?IY> PROCEDURE,NAME rJ NPtfTl JNPVTl .., 

Thu English word *10' can imply execution, For exemple, 7 m is to run his program". A 
better choice would be "deline"., 

Parsing 

S.ISP iVflid? the necessity of oarsing through the us* of parentheses. This might 
be considered welt worth emulating ih LOGO for its expl*n*tnry simplicity. However, 
Simplicity must be contrasted with naturalness. A beginner is used to using English 
where verbs end modifiers *r« connected by gramma*, context and meaning rjthpr than 
•xpJkxt parenthesising. This nature 1 ness can be preserved for procedures that take a 
fixed number Of inputs, This allows such lines Ot code to bi understood by anyone 
without any special progr&mrmng f^wledge, 

T FORWARD m RIGHT 90 

Thus, a beginner can express himse'r with no extra burden ot parenthesiring, when hi* 
programs are stilt very simple. 

Parsing can be used to permit infix notations Again it is simpler to demand thal all 
functional calls be in prefix notation. however, a beginner f* tar more familar with 
FORWARD :S!DR*W than with (SUM -SIDE Mft 

Eventually, as One’* coda betames more complex, pwenth^ses become a 
Simplifying tod. One does n*t have to guess how the pa-ser wilt work, LLOOO allows 
thi-s. If desired, parent hoses are permilted hmJ interpreted in the standard way. 
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Cr i| icisn: LOGO complicates its parsing algorithm Irt Several ways, ma h ing it 
difficult Id evpla n to a student. For example, Ihe language does no I irvs-isf that 
all orirnrtivcs 1 akr a fined rtuirPBr u J inputs,. In soma cases iuth 2 L the title 
lire* Of definitions, this is reasonable. On the Other hinck It Is aOmawhafc 
confusing to Irmll Such p^lrrtilives is SUM td only £ Inputs if not pirantNM>r*d- 
but my number q! inpul i if pirer.fhes>ied. Equally bid is the t«1 l hat 
primitive* like tl LOGO'S PHt/VTOOT for printing definition* do not evaluate 
I heir inputs. U would be more consistent lor 

TfH/VTfJLT "PflWCfi/lW 
to be required. 


Disparity 

Program Versus Data 

Seth programs and data are inle«tuHon structures. The difference twiwe-em the 
two is solely a milter of me. LISP preserves this elegant view by allowing programs to 
be passed as mpul and, indeed, to even redeline themselves. This power, for all its 
simplicity, can confuse the beginner. For Ihe- novice, the deference between defining anti 
running a procedure is unclear. LOGO provides clarification by forcing e complete 
distinction between the processes ol delinks and of evaluation. 

Criticism: LOGO violates this idea. A program tan be executed inside i 
definition if not preceded by a line number, This is a mistake. The typical case 
is foe the user to have intended fo type- the line number. In its wistful desire 
for irtprp computational power,. LOGO has forgotten its epistemological 
foundations. 

htamonyms 

LISP has Ihe ability for a word to be the came of both a procedure and a 
variable. The position of the word in ■ list then determines how It Is used. Homonyms, 
fiOwevpr, can be confusing. How should a word which is both a procedure and a variable 
be treated when it is Ihe First element in a list? The choice is arbitrary. 

LOOT prevents such homonyms. Words evaluate as variables only when preceded 

by V, 

. .. X + , causes X to evaluate as a procedure call. 

, , , :X , , return® the value of the variable X, 

thus, LOGO and LISP Share the power Of allowing any string, ot letter® fo be either a 
procedure or a variable name. Out LOOT insist* on an ur,ambiguous Total" distinct ion, 
independent dl position, between these Iwd uses. 

Another erampie of the clever ways LISP lakes advantage Of homonyms is SiL 
LISP uses this word to narnia both the empty I si and fhe logical truth value F ASSF,. This 
can result in more economical procedures. The convenience, however, ha* no conceptual 
basis. Nance, it can confuse the user who does not yet understand either list 
manipulation or logical analysis well. This is similar 1o the situation in APL, where the 
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logical constants are the Integer* Q and 1, and tondi! One's are aecOmpiished by numerical 
manipulation, II can lead Id Gesturing The purpose Pi a given piece Of code. 

line pnenled Input 

US-P evaluate? ih e^prt^i'pn when p*renth*wt bpl*ntp-, Thu* rt cannot tatch 
errors caused by typing too many right parentheses. LOGO sy-aits for a carriage return* 
He net it is captbl# o) r(hfag.niEing this problem* Furthermore, a wt' flac* *rita several 
calls Cm a Fine. Execulicn is delayed until a carriage return is Typed, this has the virtue 
Of ttfi.afalllf'ig the tifckS Of forming gl-ammalrcal csrpt-issions fco-m esedU-tirip, programs. 
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section 1. Overview af tjteImpIpmenruitHi 


LISP LOGO it dr r ,rjnrd :;□ that the .ser nsfid never know that he is communicating 
with other than a slandard LOGO. However,, iF desired, he e*n insert partnlhssiied LISP 
cede anywhere in hit LOGO program. 

LISP LOGO is basically i compiler. It converts LOGO input to LISP programs. The 
result Is that running most procedure? takes l«s time since the code need not he 
repeatedly interned and parsed. 

The Following page? provide an overview OF the irajc' part? ol the system. 
These a*e Ms reader, parser,, evaluator* printer, and error handler, More detailed 
6 k pi a nations of these will fa la* in lalsr sections of this memo. For implementation 
details,. LISP LOGO is available in welt-comrrented interpretive code. 

Code for the LOGO display turtle is discussed in Section Lb. end code For the 
music ho* in Section 16, The ’LOGO project" is concerned with more than the 
development o! a computer language. Of major interest is the design of various 
cO'niputer-i'ivBin. devices which provide * nch problem solving ewuirphment for the 
student. However, special purpose primitives for driving these devices are independent of 
LOOP versus LISP issues and must be added individually. A LlSP-basicf implementation 
does h#ve one special virtue, For those device? like the music bo? wdich are driven by 
ASCII characters, the primitives can be written in LISP Or LOGO and than compiled It is 
not necessary to create code at the machine level. 


S I Reader 


The LOGO reader is basically a line-orienled LISP reader. It returns a Hot ol 
atoms read between carriage returns. The fundamental tasks dt interning atoms and 
building list ctruclure are handled by USP- Conflicts in character Syrtta? snd identifiers 
between LISP and LOGD present the OnFy subllehes. 

Certsirv characters such as The infix Operators +> and / do iv&t require spaces 
to be set orf as atoms. This is equivalent to being a ’single character abject" in LIGP- 
CMw-r characters such a? m * in dotted pairs are special in USP but not in LOGO, The 
solution to these conflict* is lOund in using sr pot ale "rerftable^s for LOGO and LISP. 

Conflicts in names *t$o occur, Th§ LOGO user h*s access to all the Ordinary LISP 
procedures, but must be prevented From accessing LISP procedures which are internal! to 
LLOGO. This is accOmptistnsd by using two "obarrays". When the user types in an 
identifier with Ihe same name as an internal procedure, he accesses * different atom. 

MACLISP allows any number of separate *read?able’s and "obarray’s. This 
permits multiple worlds * PLANNED, CQNUVER,, LI$P r LOGO - to co-exist with no conflict. 
Switching worlds is computationally Fast- All that u necessary is 1o rebind the 
Htl/WYJliiLfc end <}B/iRRA¥ varra&las to Ihe desired world. On the other hand, the 
naive user is protected completely from other environments and need not even fcnow or 
their existence. 
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3 .? Parser 


The parser converts a LOGO Imp to list-structured form. This requires that 
informal ion on the number ol inputs used by a procedure be available. Inserting 
parentheses is a trivial compulation for procedures with a fixed 1 number Ot inpuls. 
However, complexities are introduced into the LQQO parser by: 

1. Hiuirg infix as wall as prefix operators. 

2. Changing the number of inpuls depending upon whether Ihe user embedded the form 
m parentheses £St/M, SENTENCE, 

. 3. Pt ioiifives like TO that do not parse thrr Input, 

4 - Homonyms: FimctiOns whkh have (fie same name in LISP and LOGO, but have deferent 
meanings. These are handled by having Ihe parser detect Ihe names ol LOGO primitives 
which confiicl with LISP, and convert them to Functions with different names that do not 
conllicL 

This makes the parser She mPsl complicated pari or the simulalion. 

Parsing information is stored on the property list ol i function. The msjor sub- 
procedures are concerned with prefix, infix, and user-typed parentheses. Special 
primitives are parsed by storing a procedure as Ihe parsing property. 


M Evaluation 

The basic LOGO functions that do Ihe user's computation - i.e. the arithmetic,, lilt, 
and logical primitives - are (he sUnpkosl part of 'he simulalion, These functions all occur 
in LISP, usually in a somewhat more general form. Hence, thrs part of ihe implementation 
is Mile more than renaming. For m*«xy primitives, LLOGQ provides wore argument type 
checking end informative error messages than are supplied by thcr U5F counterparts. 

Parsed tod# is executed directly by the US? evaluator. Indeed, a user -del inea 
program in parsed form is simply a LISP PROG- The I ne numbers are tags in Ihe FFfXI. 


3.4 Priming 

LOGO procedures co.id be represented as lists Of unparsed lines internally, In 
this case, a line musL be inlernacf and parsed each time it is run. However, the problem* 
ol printing fho del in it on and editing a function are simplified. The internal formal ia 
identical lo the Formal in which Ihe user originally typed the expression. 

An alternative solution is to represent LOGO programs <n parsed, oe. LISP torm. A 
LOGO program internally is a LISP program, Tfn* maximizes run lime speed arid simplifies 
building program understanders. It has the disadvantage of compl-eating the parser and 
the printer. 

I, The parser must handle functions that have not yet been defined. This can be 
accompli shed, however, by reverting (0 Ihe solution ol parsing, if run time those lines 
which contain unknown functions. This runtime parsing can after (he prq&rarr/s delimlipn 
as well so il Ohly n#od occur onco. 
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£, Printing definitions and *ditir$ lines requires an inverse parser or 'unpsrser'' which 
returns the LI$P-ified code to ils original torn*. This is possible providing there is no 
information lo-s.t lit parsing. Such it the case f the par ter makes special provision for 
distinguishing user-typed parentheses from parser-gene raled pafentheses. One way to 
accomplish this ft by bcg'Tinirrg User-list? Wrth a do-nothing function USER-PAREN 
defined as: 

(DEFUN USER-PAREN tX) X> 

3, Editing title fines is made more complex, The editor rwst reparse the liws ot super- 
procedures in which the edited function appears. This can be accomplished by 
maintaining, a super-procedure tree, although tLOGOdses «ot currently do this. 

These complications can be avoided by storing both representations ot the 
procedure. This is an excellent trample of a space versus complexity trade-off. LISP 
LQQQ currently does not store both representations. 


i.Sf Error Anitysis 

Since- LQGO Is a language which is designed to be used by beginning 
programmers, it is important Eo provide informative error messages, Consequently, all 
LOGO primitives do extensive type checking on theif inputs. LIQGQ will try to print out 
the form which caused the erro-r, and give the |fr» number if the error occurred inside a 
procedure. After a simple mistyping error which can be detected by the parser, the user 
is givEn an immediate Opportunity to correct the line, for run E'me errors, he is given 
the option of causing breakpoints. F*dll|i*s for exploring lh* flack from inside a 
breakpoint loop are available. Since LGQR procedures are represented internally as LI$P 
procedures, the standard USP 7'fiytCf! package can be used. 

These (acuities are implemented using LISP error interrupt handlers and 
EV ALFR/lME. If the sophisticated user wishes to provide his own error handlers, he can 
access the LISP facilities directly. 
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Section: 4, Performance 


41 Sfw 


USP 

LLOGQ (compiled) 


Z& Stocks (1024 36 tart words) 

7 ftnary program 
5 lisl structure 

2 Members, Atomic symbols, etc. 
40 


Total space 


These figures do not include space tor user programs, or loading the display 
turtle, music, or CEPMLANC packages. Between 5 end 1 OK beyond the .amount of jtprago 
menboned above would provide a reasonable amount 01 workspace tor user programs 
end datoi this would correspond roughly to programs of perhaps a few pa^rn. In the 
CUfrent MACLISP, storage expands as reeded. HOGD lakes advantage ol Ihis feature — If 
programs grow beyond a certain sue the user hj asked whether h* wishes the allocation 
Id be increased. Storage is expanded automate ally on loading special packages such at 
Ihe display turtle. Of the L4 blocks which comprise the LLOGQ system, all but 3 are pure, 
and can be shared among user*. 

4.3 Com pH [alion Time 

For most processing, LLQGO enjoys a speed-up over CLQGO anti ] I LOGO due to 
Ihe (act lhal parsing and interning Occur only once at deFine I’me. Further, LLQGQ makes 
it possible- to compile LOGO source programs Into machine code usmg the MACLISP 
compiler for increased elFiciency [See Section 9]. Workspaces can be stored on the 
dish in internal LlSP iorniat. [£ee Section 10,1] Consequently, re-reading files has no 
overhead. CLQCO hat an advantage, however, in manipulating words, as ils internal data 
structure if string rather than list Oriented, 


4.3 Ufe 


Almost *11 of the primitives of CLQGG *nd 1 ILGG 0 , (including the mvsic boa, 
display turtle for the PDP -6 and GT 4 Q) are implemented. Hence, LISP LQQQ is capable of 
reading, parsing and running -tnOsI fll** saved under CLOGO or ItLOGO [perhaps 
necessitating minor modlf real ion], 

It can also be used real-time by an individual familiar Only with LOGO; no 
knowledge ol LISP is required, On the other hard, all of LISP'S (soilit'es are available. 
Programs can be written m ILI'SP, or in machine language using LAP, and can be made 
callable from LOGO. The special packages to r the display turtle, music box and 
GEflMLANt) can also be used from en ordinary LISP, Some otoer facilities gl LLOGQ, Sv*h 
as the breakpoint and stack manipulating functions, are also ay a lab e tor use in LISP. 
Lt&P users can take advantage of thete facilities without totoractlon with LOGO simply by 
loading the appropriate tikes at LISP functions. 
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4.4 Availability 

The impairs nt-aliOn is frilten completely In interprelive code, It runs compiled 
under the MACLISP currently in use at Ihe Artificial Intelligence Laboratory. I lOGO has 
also Uteri impltfrented On binder d DEC POP-tO’i under the- TE.M&0 end TENEfc ayttems. 
and on MLLTICS. These implementations are discussed in Section 13 end Section 12 ol 
thi* memo, 
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SecHgfi 5. Getting Starlet 


In the tallowing setlioni, we wilt go info morn detail concerning the 
implementation ol USP LOGO, and provide some practical information for using it. We will 
nOl a^tampt la provide the reader with an introduction to the LOGO several 

• KMHepf sources- tor this already exist, such as the LOGO Primer, and the 11 LOGO User's 
manual [LOGO memo 7 J. We will assume that the reader his read these, or is already 
familiar with CLOQO or 13LCXSO, the other implementations of the LOGO language available 
al the Al lab. Ins lead, we will concentrate on pointing out di Me rentes between HOGO find 
athar implementations of LOGO, and describing -fealurps unique to Our implementation. It is 
not r-occssary to know LISP to understand most oF what follows, although some 
knowledge cF USP would he hetaM in gaining insight into the implementation. For morn 
Information on LISP, see the MACLISP Reference Manual by Dive Moon, and Ihe Irctfl-rim 
LtSP User’s Guide {Al memo 190J 


Note!ionjl consentient: Throughout th*c memo, USER TYPEIN artrf LOCO CODE 
tdlLL *ppttir in a fiiht Sikr jficj. SYSTEM TYPEOUT Will appear in a fen I tike this. CantroF 
Characters- are denoted by A followed by the character. You type a control character by 
holding down the control key while you are typihg the character, 1 mra^-is escape or 
altnWnfe, not dollar-sign, except where otherwise noted. Angle brackets * > mean 
something ot the appropriate 1/pe suggested within the brackets; for instance, if your 
user name is HENRY, <mtf name> means your user name, e.g. t-tENFTY. Except for control 
characters, which usually take immediate of Foot, and except where otherwise nOtad, end 
el( lines of lypein with a carriage return. 

The following, procedure ta intended to halo very naive users oF IT'S to get tagged 
in, end lo obtain LtSP LOGO- See A) memo ?L5, Hew To Get On the System, for mere 
details. 

1. Find a free console. A console wh-ch is free shows, 

Al ITS ■-rmi-■ □INSOLE <number^ FREE <lim^>, 


2. A console which is free understands Only One command. It is- a£. The computer will 
respond with the following messages: 

A3 ITS < vn huu >- DDT <¥er»iofi>. 

( piimW ) USEFIS, 

3. WhcO ft stops printing, Ipgm as Idltaws; type 

-JjOQW nama> 

If there *r« a ny hostage* for you, 

—KAIL— 
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will be printed, You can type a space 1o receive it or any other character to postpone it, 
A t will be typed at I ho end. 


A. Now you have completed logging in to the Al system LLOGO is a subsystem of Al ITS. 

To get LLOGO started. 


5. Decide which version of LISP LOGO you want ChSdse trtm: 

LLOGO - Standard version of LISP LOGO. Vocabulary is compatible wilh CLOGO. 

1ILQQ0 - A version which uses a vocabulary which re compatible with PDFl | iOGO- See 
Section II For da tails. 

NlLOGO -The very latest version of LfSP LOGO, Ihis is experimental, so we make no 
promises. 

When you decide which you wanl d type 
r c Jiomf of program* 
for example, :LLpGO , 


b- Then LLOGO will print out som# Initial messages, including Us version number and 
LISP’s and will ask you some questions. 

DO YOU WftJfT ID USE THE DISPLAY TURTLE? 

If you want to deline and edit a procedure which carts ns turtle display command;, you 
should answer F£S to this quest ion* It is not necessary that you have the 340 display 
scope, or the GT4G display, to do just defining and edging. You can even run the 
procedure if you do not mind not being able to see what the procedure does. See Section 
15 for mpr* information^ 

BEFLKLANO? 

!f you want tp play with GERMLANQ, the display turtle for Chirac ter displays such as 
OATAPOtNT terminals, answer FES, This has a prompter which will run some 
demonstrations and provide help if you need it. AgaiA, if you intend lo define or edit 
procedures designed to run in GEFWL&flQ, you must answer yfts. See Seel ion 14. 

MUSIC ROK? 

If you want lo use LOGO music bo* primitives, answer Ft'S. This will inquire further, as fn 
which music box, etc. See Section 16. In case you have answered FES to any of thrsr 
questions you have to wait ter a while, because il takes some time to toad in the files If 
you want to interrupt loading in type aJ£ , not ntf. If yUir have a fife named UJOGO 
(INIT) on your directory or there is a The named *«ur nuiH^ .LLOGO- on the ([NTT) 
directory, LLOGO will read it as an initialization file, executing LOGO code contained 
therein, When all this is IlnlshtdL LLOGO wilE Iftficate its readiness wilh 
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LLOGD LISTENING 

f 

7. If you find y&ursalf in the urfiforlunate situation ol meeting a bug in LISP UQQQi you 
may re-pOrt «l by using th* Function BUU- Th* ln#wt 10 BL'G should be a message 
doscrlbmg the difficulty, enclosed in dollar S'gns. for euaitiplg, 

*wc s 

TflK TURTLE ESCAPED FROM THE 
DISPLAY SCREEN . . * 

* 

iTMANK YOU. 

Yoy C*n logout *hen you ire finished by typing GOODBYE Id LOGO- Thu tvrmmil 
should then say, 

AND A PLEASANT BAY TO YOU! 

Al STS CONSOLE snumlier^ FREE <liihe> 


9. Have fun! 
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.Section G. Pirtlng LOCO 


This section will discuss a t*w ol the more La-np'ex issues In parsing LOGO -nlo 
USP, and discus-5 how they arc handled by LLOGG. LISP is 1riw*»l to parse, as its syntax 
is Icts'ly unambiguous. The application of a function id its inputs always happens in 
prefix notation, and the precise syntactic extent of a form is always dearly delineated by 
parentheses. LQOQ syntax affords I he beginning programmer some conveniences Over 
LISP syntax, while retaining much of the expressive power of LIS.P, Parentheses can be 
omitted surrounding every form, and the more customary infix notation For arithmetic 
expressions can be arbitrarily intermingled with prolix notation. These conveniences are 
bought at the cost of eompiloatinj the parser, and introducing, some cases where 
ambiguity results regarding the users intenl for some of the language’s syntactic 
constructs. 


6.1 [nftn Expressions 


LLOGO allows infix notation to be used as welt as prefix (unctions in arithmetic 
expressions. k*Mt LOGO arithmetic functions edits in both prefix and infix flavor's, and 
the user is Free to use whichever he desires. 

TFf?WJ*4*jAAWJr FJRyr.-I DIFFERENCE ;C*i7 ^ 

is the temp as 

fPRINT (TIMES 3 iMEXPT :/J ((FIRST ;XMTINE$ C I?ht)) 

LLOQO observes the usual precedence and associativity OF arithmetic operators, 

Note that a complication ei the LOGO syntax is (hit all functions, not just infix 
operators, are required to have precedence levels. Is 

*FIR$T * 17 

the same as 


rnMKS (FIRST :A) !7 or *F/fiST (TIM ES iA (7) f 

Thy* situation is further complicated by the User’s probable expectation that functions 
which manipulate logical values have lower precedence than comparison operators like 
> and -. So, 

*TF$T -.NUMBER < :PI 
ir taken to mean, 

?rESr (IESSP r NUMBER ;pf) and not ?LBSSP (TEST iNUMBER) :PI 
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CLOQO gives all arilhmelic operators the same pf«*d«rK« Oh the grounds that 
precedence would be <difFi-cu<t to explain clearly 1 0 chfldre^ However, this has the 
drawback of deviating from I he customary mathematical convention S'nnc thin motivation 
for ini reducing in<i* nOletion inlO LOGO synta* is so thal eri'hmetic expressions can be 
writlen in the inliv form in common use, 1LQGQ has been designed to obey th* usual 
proiedenca conventions. 

LLQGO trios to please everybody. IF you feel |h*1 <►* precedence scheme which 
has been imple menled decs nOl agree with yOur intuiliOn, you are tree Id re detine the 
precedents level*, *r you wish. LLOGO *1*9 provides the capability of de-bning new infix 
Operator*. 

The- initial detault precedences are identical Id those ot LI LOGO and are as 

follows: 


700: A [exponentiation] 

GOO: * - [profit] 

500: */\ 

400: * - [infix] 

000: [detault precedence for system and user lunclicmsj 
200 ;* * - 

100: If NOT ROTH EITHER AH D 0IF TEST 
50: _ [Ai/IKfc"] 

Initially, Operators- ol levels SO and 700 are right associative, and the rest are tell 
associative, which is the default. Logical Functions should have precedence lower I ham 
comparison Operators, so iF the user defines a logical Function he should set the 
precedence Nntwlf, otherwise it will receive the default precedence. The user can 
charge things by using the Following Functions: 

PRECEDENCE <up> 

Returns the precedence level oF <op>. 

PRECEDENCE <Frt^ 

Sets *op J,1 s prtcedchce level lo 1h# Specified wh*ch may either be a 

number, or anolher operator, which means that *op> is to be given the sane precedence 
as that operator, 

PRECEDENCE NIL *Jew/> 

$Ets the deleult precedence (Or functions to <Ibvb 1» All Funclions which are nol 
in the above list pi infix I unctions, at have nql been assigned a precedence by the uwr, 
receive The default precedence. 

ASSOCIATE <numbar> <toihtrh-ira 

Declares that all Functions u J precedence level *nutib*r> Wilt associate <whloh- 
way>, which is either 'LEFT at 'RIGHT. 

INFIX <a P > 
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Defines <cp> *o hr an infix Oprrnlor of precsdenca *isva->. Sp«cifylng c 
precede r,ce is op I ion al 

NOPRECEDENCE 

Forces ah infix operators lo I he same precedence level [this will be higher than 
I he default precedence]. Makes 115 p LOGO look like CLQOQ [well, ilmost,..] 

.INFIX 


This variable contains a list Of all current inFix operators. look, but don'l touch. 
Use INFIX fa add new infix operator). 


$-2 Minus Sign 

There is some ambiguity in Ihe handing ol minus sign, far example, consider 

tfSEOT’EJYCE J -:£} 

If the minus sign is interpreted as an infix difference operator, this will resull in a list ol 
One element. If the minus sign is interpreted as prefrx nega-licm. it will result in a list pi 
two elements- Cull CO uses the spaces in Ihe line lo disambiguate this case. If there s a 
space between the minus sign and the rtf, d is interpreted as inFix, Otherwise, if is 
interpreted as prefix, In ] HOGG, spaces are not semantically sig/ufkant except lo delimit 
words, so This is interpreted as fSEVTEIUCE iDIFFEKEftCE 3 tA}) regardless pF the 
Occurrence Ol spaces. LLQGQ treats minus sign as does ltLOflO. One would obtain the 
result pi the other interpreteFidn by using 

^(SENTENCE 3 (--A}) 


TFro preceding discussion applies only to the parsing of infix expressions. Sd, h*f 
Is a list ol one element, a negative number, but /- tj is a list of two elements, minus sign 
■nd 4. 


6 3 Horn any ms 

LLOGO makes all I he functions dl LISP directly accessible to Ihe LOGO user, in 
exactly Ihe same way as LOGO- primitives. This runs into dilfleuHy when a LISF* Function 
and a LOGO function have the same name but different meanings. These are currently 
handled by the parser, which converts them into innocuous atoms which do not conflict 
wilh LISP, and are reconverted upon unpirsing, Currently Ihe following function* ate 
homonyms: 


PRINT, RANDOM, Iy]ST, EDIT, SAVE {in MULT1C5 ortly) 

When (he user types in one of these, it is converted by the parser to an internat 
representation consisting of a different (rmcti&n name {LOCO-PRINT, LOGO-LAST 
I&GO-EOIT l/)GO-RANDOM Or LOGO-SAVE, as appropriate} Wfwn Ihe user requests 
that tho Ime be printed out or edited the yflpattr converts it bach lo the way it was 
originally typed In, In the CLGGG-cOmpatible version of LLOGO, when CAREFUL is set to 
non-JVft the following primitives which conflict with CLOGO are also changed by Ihe 
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pafRBn LIST i t chided to FJTIA7WT, DISPLAY Id STARTDiSPtM, GET and REAL} 
to HEAD f ILF, and DO to RUN. Warning messages are also printed in these cases. 

There is one pitfall In the currant rnelhod of handling homonyms:. sometiiws., as 
with passrng functional Hfguroents h the parser does not gel a chance la tio its thing, so 
the user may find an unexpected funct*on called APPLY ’PRINT , . . . cal s LISP's 
PRINT function^ not LOGO'*. 


6-4 Ahlirevjaljojis 


Abbreviations are accomplished in ULQGO by putting (h# name OF the function 
which is abbreviated on the property list of the abbreviation as an EXPR or FFtfPR 
property* as appropriate. Abbreviations are expanded into their fufl form on parsing, and 
are left that way. the user has the capability of creating his Own abbreviations by 

1 ABBREVIATE ^jwm nant*> nom*> 

and *r*s»ng them by 

’FFMSff «mme> 

ABBREVIATE evatuates its inputs, but doesn't. A complete Sitting of 

abbreviations can be oblHined by doing 

I PRINTOUT ABBREVIATIONS 


Parting LOGG 


Section 5.4 



LISP LOGO MEMO 


Pine 28 


Jim* 37 , 


Settlor; 7. Qgfintng and; Editing Funcliona 


In LQQQ, when the Liar de Fines a procedure ustog I'd, Or i'HJTs 3 procedure ho 
has previously deHned, tOGO enlers an "edit mode", where lines bea.mrHnE with a number 
are inserted into the procedure under modification. LOGO prompts wilh rglher Shan ,l ? H 
to indicate Ulis. The intent el hawing a separata mode for editing procedures is to stress 
the distinclion between defining procedures and executing Ihenv This distinction is not 
strictly maintained! it the fine does not begin with a number, the commands are executed 
9S they would be ordinarily, with a few eyeeptiofls (the M*#r is prevented from doing 
another TO or EDIT for instance \ Occasionally, this leads 10 errors, for instance if the 
User lorgo-t to Type tha line number -il th* b*gjrml«fi of $ line intended for insertion, 

the default state ol liOGO is to rptwn the separation oF edit mode from ordinary 
mode as in 13LOCO and CLQDO- The sightly mere sophisticated user, however, might find 
himself in an unnecessary toOp Of continually typing EDfPs and EWfl’s while working on 
the tame procedure. Since the lines typed by Ihe user for inseMion into a procedure are 
Inserted immediately when the user finishes typing the Fine, JiVfl does not pause 
anything to happen otheT than the termination Ol edit mode. The system always 
renumbers Ihe name of the last function mentioned by TO, EQ1T, PRIFtTOUT, etc. as a 
default for theta functions, so when working on i single Function, KDfT serves only to 
enler edit n ode. The user has an option 01 turning uit the separate edit mode by setting 
the variable :EDfT¥ODE to NfL This will cause lines beginning with a number to be 
inserted into the default procedure at any time. In this made, it is never 'necessary to use 
END, and EDtT will only change the rum# ot the default procedure il given an input, 
The prompter wrl[ not be changed. 

In LLD®3 i it is rvOt necessary to be in edit mode to use EDtTLIb/K or EDlTTiTLE 
on 3 line Ot Ihe detauFt procedure, and the editing control characters are available even 
when not In edit mode. 


7 1 Control Character Editing 

LLOGQ his a control -char icter line editor similar to those in CLOGG and 13L0G0. 
This makes it particularly convenient to correct minor typing errors, by providing a 
means oF recyelmg, portions of the line typed previously, insteld of requiring retyping of 
the entire line. The editor keeps (rack 01 IwO lines: an old line which you are ediling, and 
a new Fine, which LLOGO is to use as the nent tin# of input, Th# old line is always the last 
line you lyped at LLOGO, except inruiecfiately after a parsing error, when the offending 
line will be lyped out at you, and it may be edited. You can il« set the old Ime yaurseil 
to bo a l<ne in the current default procedure by doing EDITf.fNE sff nr numfjr-r>, or the 
title ot a procedure by Calling EDfTTtTLt!. Everything you type &Fter the prompter, or 
cause to appear using Ihe control characters, is included in the new line, untrl you type 
carriage return, which terminates editing for that tine, You may use parts ol Ihe old line 
in constructing th* now line by using the following editor commands: 

aK - Bet the netl word from the front of the old line, and put it On the end ol the new 
line. 

AW - Put Ihe rest of the old line it the end ol the new lino, this is like doing a£*s until 
there is nothing left in the old line. 
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ihS - Oelele u word from Ihe front of the old I na, 

a P - Delete 4 «Ord from (he end of the new line, tike ruboul, Mtcpl rubs Out a word 
instead of i character. 

LLQGO uses different Character*. ihgn limGQ and QLQQQ do toe mb a USP use* 
most Of the control characters for interrupt* and f/o. 


7.Z printing Function De finition* 

The function PRINTOUT can be used lb look at definitions of user procedures. tn 
■dWition, it has other opt ions for asraminiTyg (he state of your LLQGO. PRINTOUT dde snt 
evaluate its Inputs. 

PRINTOUT <pror»JiEr»-liglijt> /AblaiffttfM POf 

Will print out the defirn|ton pF (he specified procedure. If Ihe name is omitted, it 
will assume the Iasi function thal was defined,edited;or prinled. 

PRINTOUT' LINE <ninbH-> /POL/ 

Prints out only the speftfied tine in the dfrfudl procedure. 

pkjjvtto^t rm.E < t / pot/ 

Prints the |u±l the liHe of the procedure g,iu>«n. If Ihe input is Omitted, prints the 
tide Of the current default procedure. This is useful it you forget which procedure Is (he 
default. 

PRINTOUT TITLES /POTS/ 

Prints the lilies of all Current Irte-f procedures, ignores buried procedures t* ce 
Section lQ.lJ. 

PRINTOUT PROCEDURES fPOPRj 

Prints out I tie definition* ol nil currently defined user procedures, Will not prmi 
the definitipiij of procedures that ar* buried [see Section 10.1J. 

PRINTOUT NAMES /PON/ 

Prints the names and values of all user variable*. 

PRI NTQUT ALL fPQA / 

Does PRINTOUT PROCEDURES and PRINTOUT NAMES- 
PRINTOUT SNAPS 

Prints a list of saved display turtle scenes. Sea Section 15.31. 

PRINTOUT RUE, PRINTOUT INDEX 
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See Section 10 . 2 . 

PRINTOUT ABBREVIATIONS 

Prints a list or all currant abbreviations,, and the nar-ss at tha procedures which 
each abbreviates. 

PRINTOUT PfffMimES 

Printt a cdmp1e1e list or all ULOGO primitive, 

Another useful command is LINEPRiNT, which ciuses a listing, simitar to (he 
output of PRINTOUT r?LX> to appear on the line printer. It tahos *n option*! input, * 
word to be- used as a title to name Ihe tistirg. generated. 


7,3 Ending 

The commend ERASE wIN remove unwanted portions of your LOGO. The inputs to 
ER/TS'I? ere not evaluated. The options available ere: 

ERASE tettilm-rt, wiebl* or tup name 1 * 

Cause the definition Ot the specified Object to vanish. Note: When you define a 
function ujing TO, it check* to see if there already exitts a procedure Ot Ihe same name, 
and it so, inquires whether you want the old definition PflflfiRd. This is tp prevent you 
from accidentally Overwriting definitions of functions. 

JFR (.W tTiVR ■'pri.mitriie name^ 

The LLOGO primitive ftivin a? Input Wilt be erased. You. might use this, for 
example., it you wanted to use a name used by LOGO tor one pf your own Itipotrpr^, It 
yOu define a name using 3YJ which conflicts with a LOGO primitive, it will inquire If you 
want the definition of the primitive to be erased. 

ERASE LINE *numh*r> f ERL/ 

Erases tine ^number> of Ihe default Drocedu'e. 

ERASE NAMES fERNf 

Unbinds alt user variables. 

ERASE PROCEDURES / ERP / 

Erases all interpretive u*er luntlion*, Does not affect compiled Or burred 
procedures. 

ERASE COMPILED 

Erases alt compiled user function*. 

ERASE ALL /ERA/ 
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Like dome ER ASE PPOCEDt/rtBS, Eft/ISB «Mf PREO and EftrtSE rWMtS. 

ERASE ABRREVtATtQN *Mn*l*datP 

Erases I he abbravialion given At input, foot nal aFlecI ths procedure I ha" it 
abbreviates. 

EffrfSE FILE «ffl* *p*c> fEMJ 
See Section 10-2.. 

ERASE TRACE vtUat? fERTRj 

Removes irate from unctions See Section S.&. 

ERASE BURY -tfuntruni? fEKRJ 

The Junction! will to ion(er be buried. For a discutsicn on butied procedures, ut 
Section lOLl. 


Defining and Editing fundionr 


Section 7,3 


LISP LOCO MEMO 


font a* 


June 27,1374 


Section 4. Error Handling and Drtnjjjelng 


*"he philosophy Of the LISP LOGO •rrOr hailing system is 10 1 ry to bis as 
lor giving 35 possible; the system will give you an opportunity tp recover tram almost any 
lyp-e oF error [except e bug in LLOGO^ Thera are two types ot errors which can Occur; 


8,1 Parsing Errors 

If for some reason. LLQGQ cannot parse Ihe line you typed [for example,, you may 
have typed mismatched parentheses^ this causes a parsing error. When this happens, 
LLQGQ will print a message lolling you why ■( was unhappy, rolype the Offending line at 
yOd, and type the editor prompt character. You now have a chance to redeem yoursetl 
by correcting the fine — you nay use any of the editing control characters [see Section 
When you are satisfied that the line is correct, typo Carriage retiwn, and LLGGQ wNI 
rpsurro evaluation, using the corrected line in place at the one which was in error. 


S.2 Run Time Emirs 


When a run lime error Occurs, a message will be panted. If the error Occurs 
inside a LOGO user defined function, the message will say something lifsp: 

;EP,FI : DR IN LINE v number> OP cprilcEriu-e* 

J.INE <iuunbor> IS ; . . .. 

;*rwson for error 1- 

If the error secured inside a LOGO primitive, the message will took like: 

WOULDN’T EVALUATE <b*i in rm> 

[BECAUSE 

i<rea3im far error'- 

where -^bad (Orm> is what LLQGQ was trying to evaluate when the error occurred. 
Usually, this wilt give you enough information to figure oul where the error occurred, 
all hough "rbad form 5, is sometimes uninformative, Usually, ULOGQ will simply relurn to the 
fop level loop when such an error occurs. However, If you SETQ the variable 
tKRRBRKAK to something Other than HlL, [or H/IKE 'ERRBRE/IK . . , ] a run time 
error will cause a LOGO break loop to he entered after the message is printed. Sotting 
the variable ;LlSP BREAK to non^V/JL will cause a L6P style breakpoint to occur when 
an error happens. [For a detailed discussion of breakpoints, see below. Section B.3.] 
You can resume execution oF your program Irom Iha point at whidr the error occurred, 
by COYTI IVE/Eing with somethirg fa Oe used in place pF (he piece of data which caused 
the error, II the error was an undelinad li/nction, you may G0,Y TlS/VE with (he name of 
a function which has j definition. If the error was an unbound viriable, CflM’J’JVLrh' wilb 
a value lor that variable, if the error was a wrong, type of input to a LOGO primitive, 
&ONTI\WE with some appropriate value for an input to that function, etc, Usually it will 
be obvious from the cor I ex' what sort of item is required. Computation will be resumed 
Irom where the error occurred, with the returned item substituted for the one which 
caused the error. [Mote; the usual LISP interrupt handler fictions expect a list of the 
ww item lo be returned, while LLQQQ's expect simply the itemj, The LISP LOGO run-time 
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error handling works by utilizing th* US? error interrupt facility. If y&u don’t Hke the 
way LLQQO "handler any cf the e r r or conditions, you srn Iree to rJnsign yoyr own eri-pr 
Interrupt hjndlirs, either in LISP Or in LOGO. 


8.3 Breakpoints 

A powerful debugging, aid is the ability to cause breakpoints. Slopping a program 
in the process of being evaluated allow* the Liser to examine and modify if* stale, and 
explore the history of evaluation which led up to the breakpoint. LISP provides excellent 
facilities for doing this, indodina automatic generation of breakpoints when an. error 
Occurs. Whenever USP starts to evaluate a form, it first pushes the farm on a stack; from 
a bro*kpoinl one can examine the stack to determine wh*T Forms were IP Ihe process of 
being evaluated, and perform evaluations relative to a particular stack frame. MSP LOGO 
attempts to make these features easily available to the user, from either LISP or LOCO. 
Versions Of these breakpoint function* are also availab 1 * which can run in an Ordinary 
LtSP, without the rest of the LOOP 1 environment. The fallowing Fac lities are available tor 
causing breakpoints: 

LiOGQliREAK ^meuafS* ^eortiitrini* <r*lium-r i efii# 5>r f>M6ricieli:ee PAUSEf 

The inputs are ad Optional, and are not eva'ueled. Unless ^cbndihon'* is given and 
evaluates to Nit, IJOCQRRRAK causes the user to enter a loop where LOGO command* 
can be typed and the results prinled. This is similar to the Sop ’evet loop exceo" that 7. is 
printed a* a prompter rather than ft it is very much like repeatedly evaluating PRINT 
RUN REQUEST. If ^message 5, is present, it will be pointed Out upon enlry to the b^eak 
point- It also print* the Form in the current stack frame, which will be the call lo 
SAMtORREAK if called explicitly by the user. If the breakpoint happened because of an 
error, Ihe initial stack heme will be the One cbntaimng the term which caused the error. 
UfUUliKEAK tries whemver possible to print out The current form as LOGO code before 
LI enters a LOGO break point. However, the current version is nat always smart enough 
fp distinguish between LISP and LOGO frames on lb* stack, so ydu mnghl occasionally see 
what looks like internal LISP garbage I here. If you go up Far erjough, you are sure to find 
IN) LOGO code. A smarter version cOu®d recognize the LISP frames and ignore Thom, The 
third irvput is a defadl value tor UOQORREAK to return IF it is (jCt.VTf.M/Ed. {See 
description of CONTINUE, below] Caution: the breakpoint (unctions described lo this 
section use LISP* CATCH and THROW. Unlabelled TfTRfltFs from inside a breakpoint 
loop are highly discouraged. 


IF control-A is typed si any time, even while a program is running, it will cause an 
interrupt and a LOGO break point will be entered, 

LiSPRREAK ^tntrtffr^ ^rmnd’Eriflii^ ■^reJ'urn value* / Ath. BREAK/ 

This is like LDCOBREAK, except that Ihe loop is s LISP fPfif.VT (EVAt (READ})) 
Loop. Thin is especially useful when debugging a set ot LIS? functions ces gned to run in 
LOGO. To access your LOGO variables antt iser functions From inside a LISP break loop, 
prHfrx them with a sharp sign JV], LlSP user* note you tan interact with this break 
loop a* with the standard LISP ffRE.TK Function, except that it is set up lo allow use of 
the stack backing functions described below |l JF is typed, or (CONTINUE) invoked, Ihe 
<relurn va'iue> will be the value Of the cell to trLSfflNfci/IIC. 
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rn LISP, Aff typed it any flma will interrupt and cruse a LISP breakpoint to be 
entered. , 

ERRRRF3K 

If thra variable is not NIL. when a run Eure error happens, IXICOHKEAK will be 
called automatically. This gives you a tKinte to iihd Out w-hat want wrortg, and recover 
by CONTINUED# with a new piece of dale 1o replace Ihe o n e that caused Ihe error. If is 
initially set to NIL 

JJSPRREm 

Like :ERRftRE/tK, except that if set to sorr-ethifig other than NIL when an error 
tiepper»s h LISPBRE/IK r ether (hart LtiGUURfifiK will be called Initially set to ML 

Thn foHowirg functions can be called From inside a breakpoint to examine a-’d manipulate 
Ihe stacks 

UP 


Moves Ihe breakpoint up one Frame in the stack, printing out the form which was 
about (0 be ■evaluated in lhat frame. Th«$ wilt he Ihe fprm which tilled the cine which was 
Iasi typed oul by any ol the functions mentioned in Ihis section. Evaluation now lakes 
place in Eho new slack frame, this mean? that all local and input variable? will have the 
values they did when that form was about ta be evaluated. However, side effects such as 
assignmenl Of globs! varrables are no! undone. Frames are numbered fpr |he wer"s 
convenience,, from 0 increasing up 1o top level. 

■Lff* ^msmfcer* 

Does <number> frames up Fhe stack. Like doing L'P, ^numbeO Eimss. the 
< numt»r> nay be negative. In which ciso, th* breakpoint is moved down Ihe stack father 
then up. 

E/P < wi0M> 

Goes up the stack until a call to the function whose name is <atom> is found. 

UP *arora» 

Goes up the slack unfil the ^numbeoth call to ^alom? is found. Searches 
downward for Ihe snumber^th call to the specified function if <number> is negative. 


BOIFIV <dinii> -Cjiumfrrr> 


Like UP. except IhaE if proceeds down Ihe stack instead of up. Both inputs are 
optional, and default ** for t r P, except that <number ? default* to -1 instead of +1. if 
^number:* is given it is equivalent to UP (-^nambtr*}. 

PRiNTUP i amnief > 
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Accepts inputs as does UP y but instead OF moving !t» breakpoint op The slack lo 
the desired frame, all frames between the current one and Iha One specified are print ad 
out. This function it good for getting, a quick view ol the slack in the imnadiate vkinity d 
the breakpoint. Tha breakpoint reikairis in the same irane as before. The two inputs are 
optional, and default at for tTp. 

PRINTDOWN dai™i*r> 

Like PfUPHVPi except that the rnpuls tre interpreted is for DfflT.’V rather than, 
as for UP t that is, il prints frames going down- tha slack. 

EXIT S«tDUTl-pftlu.p> 

Causes Iha currant stack Frame to relurn with th* vilu* <r*turn‘uatue>. Thai is. 
the computation continues as ir the form in the current (name had returned wilh defum- 
valuO. The input is optional, and defaults to NIL 

CONTINUE- ^reiniTi-eatiJia^ f CO, $Pj 

Causes the IrBme of the originally invoked breakpoint to relurn with the specified 
value. TFie input is optional. Usb CONTINUE to return a new item ot dal a from inside an 
error breakpointi lor instance a new (unction name to use in pi it# of one whkh was 
undelined. Mote that in many situations, tor example From a user-invoked breakpoint or 
Irdro ah error breakpoint which expects an item to be returned as the value of the Form 
which caused the error, if you haven't moved tha breakpoint around 1 he stack, 
CONTINUE will be identical lo IXfT II the inpul to CONTINUE ts omilted, Ihe default 
re turn value specified by a third input to LfSf'fllfEii'Jif or fJFJCOflFfJTfl R wi I be returned- 
as Iht value of the breakpoint. I! no such default relurn value was given, NIL will be 
returned. 


Here's an example: 


tMAKE *ERRRREAk T 


CHANCING b SVSTEK MAKE 
T 

?TKJ SOIEWVP :N 

>i IF t N-& THEN OUTPUT UNBOUND 
WTI'fjT SCflEITUP :N-| 


lAssur* LOGO break happens! 
twhen an error occurs! 

IDeflne our losing procedure.! 

!Coun| down to 0, then! 

toval variable which has no valut! 


>ENfl 

-.SCREYY'UP DEFINED 
TSCRHR/P J 

iERHIJR IN LINE 1 OF 1 SCAEWUP 
[LtMC 1 IS: IF ;N-6 THEN OUTPUT iUNBOUHD 
-UNBOUND IS AN UNBOUND VARIABLE 
; TiREAKPt]INT FRAME 0: :UNKHJND 

2 fL iy .Frame 0 is the variable, Eval wait 

Si IwOrkiinf go this when we bombed! 

We can do any command! 

’white in the breakpoint.! 

%UP IGoir® up a frame. :b'NBOb'ND\ 
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iBREAHPOINT mhm 1 : OUTPUT {UNBOUND 
tDOWN 

{BREAKPOINT PRAME 8: {UNBOUND 
WP 'SCREWVP 

{BREAKPOINT PRAMS 4 : SEREWUP :H -1 

i 

WP '$CRF f WVP t 

iBREAHFOINT FRAME IB: SCREWUP Jl-1 

%'N 

3 

1 EXIT 'SCREWED 
SCREWED 

r 


twas the input to iRJTPtlP 
tiding down aName.! 


Iw'e* Arrive at recurs-ve invocation ! 1 
Iwhere tN had the value If 

Jir we rise pact £ cells to SCRF.WUP} 

tJV was 11 

!We deed? lor some re ason! 

IttMl SCREWVP of £ « f 

!to return the value 'SCREfFEDl 

land all the previous invocations ! 

!ol ^CfillFUP return with Ihe value! 
FSClREIFEJ) ar<l we srp at ton tovpl! 
IWesnl that fun?! 


S-4 Wrong Fi urn her of Irpuli Errnrs 

Since LOGO syntax requires that the parser know how many inputs a luficliOn 
requires! and LLQQO parses your in out as you type it in, errors may be generated if you 
change the number of inputs a function takes by redefining the function, or by calling 
EDITTITLE. Calls to I hat tunction which you typed previously are now incorrectly 
parsed- LLQGO w|l! catch most occurrences of this when Ihe function is called, and print a 
message like: 

iREPARSlPfli LINE <number> BF ^pracedurf* AS,: <rww parae> 

and attempt to recover. LLOtSO always attempts to reparse a line which caused a wrong 
number of inputs error, It is not always itossibl# to win, however, as side effects may 
have occurred before the error was detected. 


S.E Garbage Collector Errors 

Versions of LLQGQ running in BIBOP LISP pLISf* with the capability of dynamically 
allocating sI□ r age] have special hangers tor {garbage collector interrupts. It it decides 
you have used too much storage space Of a particular type, or tpq- mwdi stack space, it 
Wilt stop and politely ask if you wish more to be added If you see these questions 
repeated many time* In a short span of lime while running one program you should give 
serious consideration to Ihe possibility that your program is doing infinite COAf&mg or 
recursing infinitely. 
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8.6 Tracing 

The standard USP Tlfi^CR package may be used to trace LLOGO prrmilives or 
user functions. The tracer is not normally resident, but is loaded in when you first 
reference it. See the USP manual for details on the syntan cf its use and the various: 
options avalabl r. 


S.7 Interaction with LISP 


In debugging (unctions written in USP for use In LLQGQv it is often imnful to be 
Bible to switch back end forth between LOGO and USP too level loops. You cm leave the 
LOGO top level loop and enter a LISP RRAD-EVAL-PRl?iT I aap by y sin E the LLOGO 
function LISP. From this mode, executing (HtCO) [remember to type the parentheses, 
you're in USP1] will return to LOGO. Typing tonlrol-alsign [ao] at iny time Will cause eh 
interrupt and switch worlds you will enter LISP if you typed ah from LOGO, or enter 
LOGO it you typed it from LISP. The LISP Jppp gives ypu access to all infernal LLOGQ 
functions and global variables, which iff* normally ioBcCessIble from LOGO since they ore 
on a different obarray. LLODO primitives and system variab l es are On both obarrays,. so 
they will be accessible from both USP aed LOGO, but LOGO user l-unctlons and variables 
ore On Ihe LOGO oberray Only. The character sharp sign [V] is an OberrayswFtch'ng 
macro; In access LOGO user functions irvd variables from the LISP loop, prefix them with a 
sharp sign. 
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Section ^). Compiling LLQCQ Uifr Procedures 


LISP LOGO compiles a LOGO source program into LISP and it is stored internaliy 
only as LISP coda. Since Ihis is the eftse, the LOGO user has the capability of using the 
LISP compiler directly On Ns LOGO prOg'ams, and Obtain asubstantial ga n n eflicisncy. 
Once his programs are thoroughly debugged. USP LOQO provides ah interface 10 the LISP 
totnpilet which should m»v* it unnecessary foe the user to worry about interacting with * 
separate program. 

To compile all pf the function* turrerilty in the workspace, the Junction CGJfmE 
is available. [Th<s does not inc'ude buried procedures — see S^Nn ICkL.] II expects 
Phe word as rhpijt p to name the trie wS Ch will C Anisin the compiled rQde. Thp nnTes ill 
INj functions which are being compiled wi|r ba printed dirt. A temporary output file 
[named .LOGO. OVTPtfT] will be written on the currant directory ard delated after the 
compilation, i; complete, The Output trie will haw* as first name thb input 10 COMPILE, 
and second File name F>1SL [in the UULTICEJ imptemerYtatiafi, Ihe temporary file will be 
named to u I pud and placed in the currant directory, Tha Output file w-Jl appear in the 
working directory, with one name, the input to CEtJfPJtF.] Since the LISP compiler must 
be celled up as a separate program, be caretel about interrupting tha compilation before 
it it finished [for instance, by ^C] at you Will not find VOuhStM ih LLOGO anymore. 

To load a compiled file Into LLOG^ s*y READftLE F/ISt. This will load 

alt the -complied funtlioos which were compiled by COMPILE Shame*, and also restore 
the VtlUK o+ variables thp-t were ctefinpd at Shit time. The names ol compiled functions 
will be kept on a list tilled rOO.UP/I.Bfl and no! on ,’CflWEiVTS, For debugging 
purposes, you might want to- read in both the compiled and interpreted definitions of the 
earn* functions, and- you can i&e the functions FLUSHG0MP1LED and 
FLUSH INTERPRETED to switch back and Forlh between compiled and interpreted 
detiriitinrit. 

The LOGO COMPILE function supplier declarations for LOGO primitives. Some of 
the declarations include LISP macros which replace calls to LQGQ primitives with calls lo 
their faster LISP counterparts for efficiency, and some Optimal ion- is done. For sa>fo1y + s 
sake, all variables are automatically declared SPECIAL However, the sophisticated user 
ra free to include in hit program DECMJtfi* to L'lVSJF'ECJill input or local variables 
which he knows will not be reterenced globally, or provide declarations which will make 
use oF | he last-arithmetic USP compiler, 

A tew warnings about compiling LOGO procedures: First, remember that LOGO 
syntax requires that it be known how many inputs a junction expects, beforn * decision 
can be made as to how to parse a line of LOGO code. II, wher, defining a procedure, you 
include a cal-l to a procedure which is not yet defined, parsing is delayed until run time 
[see Section 6 and Section 3.2 ol Etes memo for mare details} The compiler, of courr.p, 
cannot do anything reasonable with an unparsed Fine Of LOGO code, so atl parsing must 
be completed by IN time the- definition of my procedure is compiled. The COMPILE 
1 unction attempts to make sure this is IN case. There ter#, if It an error to attempt to 
compile a procedure which contains a ciil lo a procedure which is rwt a LOGO primitive 
and has not yet been defined. 

Also, it must be remembered That con-oil el on of LOGO procedures, I be those of 
LISP, is not "foolproof", II it not riways the case IhaL a procedure whkh runs correctly 
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when interpreted, will fee g,uar jntead to run correctly when compiled, SfrH-modifying 
procedures, weird control ElructurM, ?rrd In general procedure* which depend heevhy Oh 
maintaining the dynamic environment Gf the interpreter W*y MU 1o compile correctly 
without rrod ficahon. 
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Section IQ. Using Files In LLQGQ 


A (Ho EpecEftc^lifrn on. ITS has lour components. Each File is narred by two words, 
of up to si* characters oath, m device [almpsl always DSlf}, »nd a directory name [usually 
I he same as The user’s name}. You can reFer to s Fite in LOGO by using anywhere from 0 
(o 4 words. If you leave pvt Ihe name altogether, it will be assumed Chat you are 
referring Id the Pasl fife name mentioned. One word will be taken as the frret file name, 
and the second will delauli 10 >„ which means I he Nghest numbered second file name 
which currently exists ii you are reading, or one higher rf yogi are wriling. Two words 
will he taken as the two file names., and th* directory and device will be del suited. If 
three names are given, the third will be assumed as the directory name, and the -device 
will be D5K. If (our words are given, the third Is device and Fourth is Ihe directory. Here 
are some examples: 


[Assume that the current user name is fSG, and TOO 3 is the highesl numbered File with 
FOO as ils lirsl filename) 


LOGO 


ITS [<fnj> <dev>i<dir>;J 


WK/WFlLE foo 

TSAYE FOO 

?ft£/ID FILE FOO EAR 

tREAtrFIW FOO EAR MENRV 

7RRAOFIU FOO EAR DSK HENRY 


FOO > DSKrfSC; /FfHt 3/ 
FOO > D$K E5G: /FOO i} 
FOO MR DSK;ESGi 
FOO BAR D5K:HF.NRY; 
FOO BAR DSK-.HRNRY; 


See Section 12.2 and Section 13 for information about file specificalions do the 
MULIlCS end TEf^Q implementations. File specifications are accepted by LOGO in the 
same format a? oo ITS, SO it may not be necessary to charge aoy code to run on other 
implement ebons. 


10.1 S aving ami Reading FilM 

There arc twp ways Of sloping LOGO programs on the disk for later use. To store 
Ihe contents Of the current workspace [all user Functions and variables currently defined] 
on the disk in the Form of LOGO s&urce code, use SAVE, ft expects as input a Hie 
specific atidr, as discussed above. The fife created will contain She cOmtenls of Ihe user’s 
workspace, function definitions and MAKEs lor voc ables, exactly in the form that he 
would see if he did a PRINTOUT ALL 

Workspaces can also be saved In LiSP rermat, as they are represenled internally 
by LOGO- This is accomplished by Ihe function fFFTFA which lakes its inputs as [foes 
S4L'#J. Although the (ile crealed will not be so pretty to look at if you print it, using 
WRITE produces files which are considerably faster to reload, since the program dees 
nol have la be reparsed, For long-term storage of programs, however, it is recOmmerded 
thal you use SAVE rather than WRITE, Changes in the implementation qf LISP LOGO may 
result In changing the internal Sormat n( LOGO program®, rn which case, liles created by 
fFHfFE would not remain compatible, but files creeled by SdPB would remain so. 
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To reload a file from Eh# disk, use the fundiOn RKJIDFIJ.K. This accept* a 
slandard file specification, and rei* it In, printing the name of the h lile. READFILE does 
not tar# whet he* th# file is in RAVFA or JFffifrien form. If Eh# hi# wi; created by SAVE, 
tines of code will be printed PuT as they com# in From the eHsh. For written files, only the 
names O' I unci ions and va'ues of variables will appear. If your get annoyed at alt this 
output, you can shut it up with ft ir. LOGO wilt return wilh * question mark when the 
loading is complete. 

II is often convenient to Ereel a set of functions as a 'package' Or 'subsystem*. 
For instance, you may hav# a set of your favorite factions which you place in your 
toiliadieelion file, Or a set or Functions designed lor a specific purpose. If/Nm tt-is i$ the 
case, it is inconvenient to hare all the*# functions wriltan out when you are working on 
additional procedures. Or have to see their delinilmns when ypg do a PRUVTOL'T ALL 
That is, one would like a method of having lha package OF Functions ava’iable, but no! 
considered at cart of the workspace by certain commands, Te>u can cfO this by using ihe 
function BtJIfV. It takes unavalualed procedure names as input, and will assure that Ihe 
function is ignored by Ihe following commands: PRINTOUT PROCEDURES, PRINTOUT 
ALL. PRINTOUT TITLES, ERASE PROCEDURES, ERASE ALL* SAVE* WRITE and 
COMPILE. Otherwise the lunction is unalFected, and can be invoked, printed, edited ek- 
A list ol the names of buried procedures is kept es the value of th* variable iHL'RIED. 
HURT ALL vi i! I BE.WT all currently defined procedures, and Efl/ISC flt'ftt will undo the 
elfecl Of a ill/HF. 


UX2 Other File Commands 


PRINTOUT FILE [abbreviated POF] will print oul Ihe contents of a file. ERASE 
FILE wilt cause the specilied file to vanish [This has a saFely check to make sure you 
donT do anything you'll be sorry about}: These like file names as above, excepl that if 
only on# input is given to ERASE it deFaults to <•, Ihe least numbered second file name, 
again for safely reasons. PRINTOUT INDEX fPOIJ will print oul alt Ihe File names in 
Ih# directory specified by one word. USE will change Ihe name of Ihe default directory. 
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Section 11. Difference! between LI LOGO and U OCd 


LlSP LOGO was originally written is be compatible with CL0GO, a version of LOGO 
written in PDPIO assembler language, There now grist* a version of LLOGO which w* 
believe to be "semantically cdmpahb’e" with the PDF31 version-. By 1 his- 'wc nte-an that the 
vOcabiilary b the same — any primitive in 11LOGO also exists in LLOGO and wifi 
(hopetntly} have the same meaning- LLOGO in feet has many primitives which do nOl ama-t 
in 11L0QD, as well as offering the user access 1o the lull capabilities df USP- There are 
substantial differences between LLOGO and ItLQGOwith regard to file systems and error 
harding, and somewhat lass substantial differences in the editor,, turtle and nwh&it 
packages. These are described in detail in other seel ions 01 this documflnt. There are also 
arc several less substantial differences,, not mentioned in the preceding discussions, and 
wh#t Inflows is an attempl 1o provide t reasonably complete lt$1 ol the knowledge that am 
experienced 11 LOGO user would reed to use LLOGO. 

In 3 LLOGO, the double ■quold character * is used to specify that the atom following 
it is not to be avalueted- 

?P RINT ~FOO 

FDD 

II is like LISF's single quote, excepl that it also affects the LOGO reader’s decision about 
when Id stop mrludirg successive characters in farming the name Of ah atom. In 


?PRINT -.FOO+3 


the plus sign is a separator character! it signals the end □! the atom jiusf as if there 
Was a Space following :FO(). however, Fol'-Owing a double qubfo, I he only separator 
charecters recognized are spice, carriage return, and square brackets. Thus, in 11 LOGO, 

'PRINT "FOO*3 

FOO+3 

In LLOGO, the user may use Ihe LISP single quOlo Id specify that an atom or 
parent he sized list (allowing the jing i* quote is not to be evaluated. The presence Of the 
single quole does not change the way LLOGO dncidcs when an atom ends. In UQGQ, 

?PRfW FGO*3 

; TME IMPUT TOD TQ «-15 OP THE YY3LQNG TTFG 

because the plus sign is still a separator character, LLOGO uses the double quotas as 
CLOQO doesj they are always matched. If one s-expression (alom or list) Occurs in 
between double quotes, il is -quoled. Il more than Ona Occurs, the Fist containing them Is 
quoted. The correspondence between LLOGO double quoted expressions and U5F s- 
expressi&ns is as (allows: 

"" —> |VfL 

(QUOTE 

“<i I> . t , —> (QUOTH Uii> ,,., ■ c iiV»)) 

"to I* ,. cjjV>r —> (QUOTE f<i|> , + . *mN>)) 
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Square fractals in 11 LOGO speedy quoled lists, Perenlhfeses art nev#r uted 
around lists as in LIS-P^ but ate only creed 10 delimit forms. LLOGO recognises square 
br achels as well a:. Ll$P'a parentheses in de "cling lists. The- difference between brackets 
and parentheses in LLOGO h thal the brackets always denote fist const ants, and not 
forms, and that the outer level cF brackets is implicitly quoted' 

f/FOO Ft flR/f > (QUQTK (<FW RAF))) 

There is e minor pil fall in the current umple menial ion: note that top '-eve' pa T en1bases 
implicitly quote the list, interior Ones do- not. This docs not always work, for instance 
when using JFL/JV one- may expect nte ■ =or lists also to remain unevalualed 

)PRINT f PRINT }TOO BARjj (PRINT '(PRINT (FIX) BAR))) 

FBI NT {FOG BAR) 

ffiUW {PRINT fFOO BAR}) — (RUN '(PRINT (FOO RAF))) 
prinls the vatue Of the luricti&n F(X) applied to mpuT BdF, 

Square brackets in fclLQQO also share with double quotes the property described 
above of afFeeling the LOGO reader's decision On ending the names of atoms. Wilhin a 
square bracketed ist in I1L0G0, an atom is terminated only by a space, carnage return 
or bracket. This property is nOl true of square brackets m (.LOGO. In LLOGO, fF0Q*3) is 
a list containing three elemenls, bul in 111000, it coni Bins Only One Blerrenl. 

String quoting <h LLOGO is accomplished using the dollar sign character, J. LLQQQ 
will treat anything appearing helween dollar signs literally, wilh special eharaclprs devoid 
of any special meaning. Wilhin such > siring, two consecutive dollar signs will be 
interpreted as a single dollar sign. $ 0 , JJJJ would be 1 he word whose name is a single 

■dol lar sign. W is the empty word. FubOut, edit mg and interrupt char &ders cannot be 

quoted in this manner. Use the A$Cff fund ion oF LISP if you really need them. 

The character Sharp sign [V*J in UE.ODO 15 used as a preri'K macro character 

which lakes une inpul whkh must be a word, and executes It as 4 procedure. It is used 

where One wants to use a webd name for a procedure, or a nHme already used by the 
system. Sharp sign is used as an escape 10 call that procedure. Thus, a procedure 
defined ih 11 LOGO by TO ~PRINT ,,, would be called by RINT t TO *3 .., would be 
celled by e'J, etc, In LLOGO, sharp sign is used as a macro character which causes the 
nesrl s-enpreesion to be interned as if it were read ih LISP II you are in LOGO 1 , or as il it 
was read by LOGO if you are in U5P. If you are in the LISP mode of LLOGO and winl to 
access your LOGO variables* you can say arFCJflv etc. The cQnFlid may be changed in the 
■near future by altering LISP LOGO'S macro chjracter lo one thil does nol comFiicI wilh 
i 1 LOGO. Suggestion* welcome. 

The Boolean [Ipgiqat] coftslants in 11 LOGO are TRUE rnd f/ILSF, while m LLOGO, 
they m-re T and NH^ as in U5P- 

The 11LOGO Fu«lion LEVZI*, which returns the current procedure depth, is not 
implemented. 

11 LOGO farms are divided into Iwd categories: those thit output [return a value] 
end Ihbse which do not. In LLOGO, •* in IJSP, every 1*rm returns a value. To tutiulete 
I ILOQQ end CLOGQ in Ihis respect, as a special hack, forms which return a queslion mark 
do not hive | heir values printed by LLOGO’s top level function. However, LLOGO cannot 
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catch the error a\ rurh i form hid ng inside parentheses, «; tin ] [LOGO. Ktasl o! the 
primitives which do no! return a value in JI LOGO relurn ? in LLOGO- 

The tharactet j in 1J.LOGO -b treated as a macro "Iha value oF if ft is hound 10 
B and- B is. bound to G, then i\A is C. In LLODQ. variables se* by MARE sro just U9P 
atoms beginning with I he character r, so cil will br the value of the variable set by 
MAKE m :A" ^wbaletwr 3 ', ett- We are seriously considering changing this,, eliminating (he 
Incompatibility. The present setup requires MAKE to do an espe-nsive KXPI&DE On Iha 
variable naTe, in Order to create the word which begins with a colon. 

LLOGO e* peels to find-only one form inside parentheses: constricts like 

1(FH JBO FD ,'iD 5EVH t 5) 

are prohibited. 11 LOGO allows more than one (Orm inside parentheses under certain 
restrictions, 

The llLQGO procedure TEXT, which returns a list of lists which are the lines of 
i procedure whose name is given as input, is not implemented m HOGG, However, you 
can access the definition Ot a tunction in its pirced LtSP form on the properly list [CUfl] 
of the atom, 

Comments: LLOGO understands two comment conventions: DSPs convention ot 
treating as a comment anything be I ween a semicolon and Ihe neat carriage return, and 
LOGONS of treating, as a comment anything in between esctemaliOn points, [The 
exclamation points mus! be matched, and commenls can be continued past the end Ol the 
line]. Anything, after exclamation pd-nts On a line is ig-O'e’d. 

The top level loop in LISP LOGO is a REAB-EVAL-PRINT topp whereas PDPfl 
LOGO is a READ-EVAL loop. This rre-ans that ] lLOGO prints out only when you ash it to 
print online LLOGO which prints out values after every evaluation Ot a LOGO form. 

tn 11 LOGO: 

?SUM 4 8 

YOU DOtfT SAT TV HAT 'TO DO WITH 12 

In LLOGO: 

''SUM 4 S 

12 

Line numbers can be any integer inside the I MUM limit. Floating oomt, negative 
number? and zero are allowed also. 

Percent Sign (X> does not echo as a space. Carriage returns within square - 
bracketed lists prinl Out as such, not as spaces, as In It lOGO. 

iEIUPTY is Iha empty list, which is LISP’S NIL, :EWPTTIF ij the er^ly word, 
which is the LISP atom whose print name is (ASCtI Ok 

The character conftrot-T [^T] is converted to double quote ["] when it is reed id. 
This is for co-mpalibility with CLOG& i haven! the faintest idea of why CLQGQ does if. 

USP LOGO and 1ILGGO differ on the syntax for arrays. LISP LOGO uses the USP 
array feci|>!yi !o define an errey use: 
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1ARRAY T l>... sdimeruion ^ 

Values can be stO r ed by 


1S-TUKE neme* cafeburipl rfpi N* ^turfue* 


Values are accessed as if I he array were a function which expected I he same number oF 
inputs as the number fit di [Tensions in tl*e array. 

The LLOGO function R/1N.D0J(, e! no inpuls, returns a random floating point 
number, which is between rero and png. If given two 3 r fcuirWs, it returns a random 
number between its first and second argument, inclusive. tf both ils inputs are fined 
point, it returns a fixed point number, otherwise It returns a floating point humber. 
(RANDOM 0 9t behaves as l 110 GO 

a 

LLOGO has Only One global test box. When a subprocedure performs a TEST Ihe 
result replaces the result produced by any TEST'S prior to the subprocedure call in its 
superprotedure. fFTRUITs usd fFFATSE?* liter the subprpcedure call in the 
superprooedure will be conditional On the Iasi TEST which was performed,. regardless of 
what procedure it was in. 


ROUNDOFF in LLQQO takas either ore or Iwo inputs. W given one input, the 
number is rounded lo arv inlegar, otherwise it is rounded to is miny places to the right 
of Ihe decimal p-oih| as specified by the second input. 

IjQC/lt. variables are handled diflergntly in LLOGO thin in JI LOGO, Regardless of 
where e LOCAL statement is placed in a procedure, the va'iables declared will be local Id 
Ihe entire procedure. This corresponds to a PftfJG variable in LISP. IffC/IL accepts any 
number pl variable names as input- 

inserting lines into procedures under program control should be done using the 
function INSKRTUNFL In 11LQQO, the following will insert a line into Rf.TTCH when 
MUNC is executed! 

?ro MVNC 

>it) EDIT RLETCH 

*29 10 PRINT f NEW LINE ADDED TO HLETCHf 
>RND 

This will not worn in LEJQQO. Irvsteid replace line 20 with; 

>20 INSERT LINE 10 PRINT {NEW LINE ADDED TO RLETCH f 


There ■£ a memo by Wade Williams which explains some of the finer points of 
11 LOGO syntax, and should be consulted (Or further internal ion. The 11LQGO Users 
Manual should also be bt assist arse. 
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Sect ion l? L Using LLOGQ on MULTICS 


LISP LOGO has now been implemented on MLTlTICS, and thts it the only version of 
LOGO available for that system. Below are instructions for using it, and a list Ql 
differences belweeni Ihc MUtJICS and ITS version*. Except for the differences in file 
naming conventions, and limitations imposed by the Operating system, source language 
programs should bo entirely compatible, for more information on kAJLTICS LISP, see the 
MACLISP Reterence Manual by Gave Moon. 

Thfr LISP LOGO music package is available for use On MLtTlCS. See Section IS for 
tntjfe details, The display turtle and GERMLAftf] packages are nol available m the MULTiCS 
implement at-on. MJ.FICS does not have adequate facilities fb r using displays such tut the 
340 and the GT40. It probably would be passible Id implement a rudimentary turtle 
pocKage for the storage lype disptayE On MULTCS such as the AHUS and TLKTROMX 
terminals;,, but we have no plans to do so al present. We do hope to have available soon, 
however* facilities for usir-g the mech*rticjl floor turtte* [controlled by the Thornton EJoi]j 
on both ITS and MULTICS. 


IjM Where To Find Jl 


To obtain LISP LQK}, you iwjeI first create l Imh to lh# necessary files. Alter 
you log In* type 

finJc 

This needs lo bo done only one* For each user. Subsequently, you can get UCGQ simply 
by I y ping 

lege 

You should then got a ipessa^o indicating the version number* of LISP and LOGO, « on 
ITS, and the allocator will ash you iF you want to use the music box. If you have a Frle in 
your directory named i-iari lip.Jefe it will be read in as an initialization file. 


Ig.2 Fete Naming Conventions 

An ITS File specification consists of I wo file names or up to six characters each* a 
■device and directory name. A file specification on MULTICS i* Called a "pathname", and 
-consists of arbitrarily many components each naming a node in a tree structure of 
directories and segments {liles] The components of a MULTICS pathname ero separated 
by characters, Any pathname- beginning with is considered to be a full pathname, 
i.e. si art b( the root ot the tree, Olhorwiss P il is-considered to bu relative to (he directory 
which Is currently the default. This will usually be something like ">udd>yQur-project- 
pama^yOur-ussr-namp", File namps ate assumed also to have two component* as on ITS 
and you lype them into to LOGO the same way, as two words, except that each word is 
not limited to six characters. The del suit second Fite oame is ■Inga", not to be 
consistent with tAJLT?C5 conventions, M yOur directory, the two file names will appear 
separated by a V, Fites whose teco»*d names are "fssl“ are assumed 1o contain obiocl 
code produced by the- LI$F compiler. This will correspond to the file with only the first 
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nemo [no second component] in your directory. Here are toms * ramp ins: [assume your 
name it -person" and yOur project is “project’] 


LOGO Pile name 


MULTICS file new 


foo 

?i"i tad file foo A-nr 

^rwadfilr foa fa-tl 

VeoJ/dfe /"w Artr muriate 
TnratIJHw finr bttr >nid*llt>fa 


^pre Jenl s primcrn^/W-Anr 
>uJd>prr>j>(^>|)#rji(Ki>/[W 
ff/ecr* perf Bti^ ithi 
> ud'[f > Wci fo>fiw.b nr 


Iti Termiinfaygy 

On WUt,TICSi control characters are entered 1o U^P by t rst hitting thr frraafc or 
one Koy [iF you have one} and Lt$P shcndd type CTRL/, then typing the ordinary non- 
controt character, then a carriage return MULTICS has no other way at achnowtede'ng 
your existence trelOre you hit a retina which is the reason for this kludge Because of 
this the control-character line oriented editor which axis I a in the ITS implement atran, 
does not exist in tti* MULTlCS implementation, MULTICS uses t to rub out Fl*v: previous 
Character, and £ lo rub nut the entire line. To e^ter these characters to ULCXSQ, precede 
them with 

It ydu should have td use an IBM 274L terminal, remember (hal certain characters 
must be escaped. The worst ol Fenders are ( and / [type <reec-jijn> <tr\x-ihnn* for / 
and ^eenl-iijjt^ < l greiiier'ihnri> few }\ t type <nn’i-sifji> for a, Crcn[-ipjjp> ■errw -ji s ji^ For 
V acid type a before * and 9, Upper and lower cases are distinguished an 

MULTICS, and all fit the system Functions, bath MULTICS's and LLQGQ’i, have lower Osc 
names. 


To uve LISP LOGO on MULTICS Over the ARPA^T IrOro ITS, it is recommended that 
Dave Woon’a program TN6 be wod ratNif (hjri TELNET. See D3 KlIIYFO.;TN 5 INFO for more 
details, 
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Section J3. Using LLPCQ on TENM ami TENfclt* system* 


Tha version dt LLOuO (or T£W60 runs ip* a version of MACLISP thdt is nearly 
compatible with that used e( MIT-AI. The TEN50 version can also be used nn TENEX 
systems. Most of the incoirpatibihlies er* those necessitated by (be difi*refi£e (b 
cparat.rg, systems. 5oeciiically, (be (allowing commands are nol implemented: 

PRINTOUT INDEX (alia * POl t LIST FILES) 
tmOVT (BYE) 

COMPILE 

IfNEPRINT 

BUG 

Also, the special packages for LL030 {the turtle primitives, Iha music primitives, and 
GERMLAhJD) are unavailable, 

Another difference between TEN5G LLOGO and (.LOGO dn tTS is in the typing of 
control characters {such as AG h Aff, and all the editing, characters j aR aE etc.}. an ITS 
these characters may be typed at any (rme. Those specifying an inlerrupt action <aC, nfl) 
Will always take eFfect immediately. UnFOrtunately, this is not If ye in the TEhEO 
implementation, hecausa fENBO allows a running program to be interrupted only by the 
character AjC. As a resull of this, it the user wants to interrupt the LLOGO system wtnle 
it is running i>. g. executing a user delined function), be must lirst type nC. This will 
inlerrupt the program, and cause it to print ?A, indicalmg that it it waiting to read a 
control *c ha reefer. The user may than type the desired control-character, and it will be 
acted upon, Mote that typing aC is not necessary if the LLOGO system is not running, but 
rather waiting for input. Therefore the edging characters may be used without difliculty, 
*v*n on (he TEf^jO system. 

Another minor difference belween the two Operating systems is in tl^ notation 
for File names. This difference is tjtinlmijed by the synta* used by the LLOQO file 
commands. For instance, the command 

IREADFILE PROGRM WO D$K USER 

will road the tile DSKdUSFft; PROGRM WO on IT?, while on TEH5Q the tile read will be 
DSK-PROGFM.LCOfUSERf. Thus most user programs will be able to run wilh litlle o-r 
no modification to their »nput/uulput operations. Stole that (he default second file name 
is * on IT?, while On 7EN5Q it is tGOlt If you want to use a LLOGO initialization file with 
Itw TEFCO implementation, Ihe name of Ihe File should be JNIT,LC0 on your user 
directory. 

A version of TEM5Q LLOGO Ie currently available it C*rnegre-Mellon {CMJ-IQB-L It 
may be loaded there: by mean; ol the following command: 

FUN DSK:UKOiAmLG99j 
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Section 14. CE&MLAN& 


The GERWLANO package is designed to provide the user with a display 
environment in which inte r es1ing nontrivial questions can easily bo investigated, without 
the need Tor sophisticated display equipment The currant implementation runs on ary of 
the character display ccmwlei in use at the A.I. laboratory. 

Conceptually, GERlAANO consists of a SflUite firid, on which way *live" as many 
as |fl- “germs'. Each gem may have an arbitrary LOGO program pssOcijdrd with it this 
program detenTHnes the (prim's movements, as well as whether it eats any Of the "food" 
present at its posiliOn Ot the grid. Pfrr a discussion of some pt the problems that can be 
investigated in (h|$ enuirorwent, see LOGO working paper 7. 


J4.L Starting Up 

The CihSM ANQ package may be loaded automatically at the start pF an LLQGO 
run. When started, LLQGQ witl ask. which Of the special packages you want. Simply type 
IfES, followed by a carriage return, when it asks whether you went GERULAt®. The 
GFRMLAND package will than be loaded, and giva yo« instructions (or further help. Note 
that if the grid becomes garbled) because oF a transmission error For inslance, you can at 
any time cause it to be redisplayed by typing the th*r*eEer a\ [control-backslash]. 


14,% Top level Primitive* 

flUSCF.RM 

Invokes prompter. Asks questions necessary to get started and otters help, 

GERUPEMPS 

^dns a series of demos, leaving the demo programs available far the user to play 

with, 

TOKMJf 

Slatts up a GERMLAND READ-KVAL-PRfWT Iwp, using the grid set up by the 
most recent call to At/MJEffW- 

UWGKiD 

Exits from TOPGERM, b-KK to LLOGQ. 

fffPK^r ^propniii h ^jirSfrtifflir 5 □, 

Each program defines one creature. A round consists oi Onetutirf, each program 
in turn. After each round, the program waits far input. H the user types a specs, One 
round is performed; If lb* user lypes a number, that many rounds are done. This is 
repeated indefinitely until an error occurs. REPEAT is not subtle with respect to 
parallel processing. Nb effart is made to try each program and see whelher any -cOnHiet* 


GERHLAND 
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orru'. However, eventually a more elaborate version could be designed that wes 
sensitive to synchronising the lives Of (he germs. II no programs ere pan sec* to REPEAT, 
if al tempi* to use the programs assoc a led with each germ by flt/JVGICTJf 


14.3- Grid Primitive* 


GRID 

initializes GF3M. AN". A square grid is c r aaied with <number> souares in a side. 

PRISTCRID 

Clear screen and redisplay CERMLhNC grid. Typing n\ also causes this 14 
happen. If (here is a germ On the squire, the character which represents that germ is 
printed in (he square’s position. If the square is an obstacle, an ")(" is printed. It there i-s 
Food On the square, the number of particle* ij printed- II the square -s empty, a V is 
printed. 

GRtDP 

A predicate which Outputs T iff Ihe positionit a legitimate grid square. 


WRAP 


GO into "wraparound" mode, in which germs are allowed to go across the 
boundaries of the grid. 

NOWRAP 

Leave “wraparound*mode. 

Mote that r If ZIP and jVQITMP alfect the variable :IFHflP>lfiCH/™. See Page AG. 


Lffil'E iij inn > 


The gem is mooed to the specilied grid square, ^position* is a sentence Of the * 
and y coordinates OF the square. Typical use is: WCF^fi iVOflT’i'J if the germ moves to * 
square Which is already inhabited, the former inhabitant is silled. WIWT prinls an error 
message if an attempt is made So .KOfE' to a square with on Obstacle On it. Or a square 
Outside the grid. The <pflm*tiOn> does, not have to be adjacent to the current location of 
the germ. Hence, MOVE allows non-tbcal movement to any grid square. 

STEP crfireciwa^ 

^direction* is interpreted as a heading. Ft must be either 0, $0, IdO or 570 (rnod 
360). STEP allows more elegance in (ho description of a germ program, If the same 
structure is used for alt directions, then the program can call j subprocedure whose input 
1$ cycled through fho (our dlrectmn*. 
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H.4 Property Primitive* 

PlfTSQi.JAFK <potilloH> <infnrmtziinn> <pVp&ty> 

For the specified tetufrft, tNs data stored under th* given property it set to 
information*. 

CETSQUARE ^paimcm* *ptap*rtf* 

The information stored under the c prOper!y> is returned. Typical uses a^ei 

fG KTSQfJA HF ^poticiiifl^ ’FOOD) returns food* at <posi1ion>. 

(GETSQUARE < r »jltlan> "INHABITANT) returns the number of the germ 
Currently living there! ML ii urflCtupied, 

(GETSQUAHE ^jwaiiwwi* 'OBSTACLE) returns T 1 iN (he tqu*re is an obstacle, 

REMSQVARE *potitw/P ^property* 

Removes information stored undar <proper1y>_ 

IF HAT 

Outputs all of the information slOred for Itw given position 


FOOD 


Outputs the number af (cod particles at the given position, FOOD returns 0, not 
NIL* when (hpr© ^ no food. 

FQQDP <poti[i*N> 

Predicate which returns number ot food parlicles if any at (he given positiPrc NIL 

if none, 

F1LLF00D <n > 

Puts v n s- morsels of Food On each square OF GEfiMLAMD. 

E/IT dmHb(r> 

Subtracts ^number* Of food parlicles from the current square, Generates en 
error if ^number* rt target thjn the total Food available. There are two types of germs 
— those that are hungry and those that are not. Each hungry germ has a Food supply 
associated with It, The food supply i* increased ©very time he eats by (hat number of 
particles, and decreased by one for each generation. It it over reaches zero, the germ 
dies. 'SO* if he eats only on* particle ol food on a turn, ho must eat again on the neat 
turnj if he eats % he can ship a turn without ealing, etc. 
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14.5 Multiple Ctfm pflmlHwi 

WHERE 

Returns the coordinates of tho square that It currently inhabiting, 

NORTH P <gtrm> 

Re turns true only if (to * coordinate of germ m: greeter thin the K coordinate of 
I he ? r ern whose program is currently being executed by REPEAT. 

SOUTH P< WESTP, EASTP 

* 

Analogous to NORTHP. 

KILL <igttm' r 

Assassin a let ':gerrji> end prinls eulogy. 

GERM <:fnrm> <afOj0J'«> 

Initializes :germ to start out located il '■"square*. igerm is an integer between 1 

and J 0. 

FPQDSUPPLlr Cfifrm* 

Returns the amount ot food that the germ has, 

ACCESSIRLR <ffbeiW> o rje rm> 

True il and only if ':germ> tan gel to ^square* on hrs ne*t move. 

I4 B Turtff Primitives 

HEADING 

Returns the current heading of th* gertin 
FORWARD ^na.mhrr^ 

Move <nun*bef> spaces in the direction of the currenl heading, Abbreviates to 
I'D 'number?. 'number* may be negative. 

HACK ' : ihimtsi ,i 

Move ^nymber> spaces opposite to thp cwrerft herding. Abbreviates Ed EK 
'number*. 

NEXT 'direelwn* 

Returns the coordinates Of Ihe next square in the current direction. 
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BfCHr 

Turn t igihl dumber* decrees—<nwnb*r> should he f multiple et 9Q, ¥>»i* «ey be 
abbreviated as RF <rvumber> . 

LfFT <nu.pn(flr> 

Equivalent to RIGHT -<nurnb#r> r Abbreviate* a* IT <nwtlw>. 

FROtfT 

fit(yrn* coordinates pf the square in front qF the Turtle. 

HtCtlTSWE. REAR* LEFTSIDE 
Analogous to FRONT. 

FSWE> RSJBE> BSWE. ISIDF, 

Abbreviations Fgf FRONT etc. 

M-T TwohFHm iljiw 

TOUCH 

Outputs NIL It <position> does not contain spmettiing that can be touched. 
Otherwise it outputs en atom describing the touchable Object, e.g BORDER or 
OKsr/KTf.K, Typical use Is: TOUCH FRONT. 

OJISTfitiCT <ii}Uiire> 

Puts art obstacle at ^square*. Germs cannot move onto squares with obstacles. 

OBSTItlCT <Jrfu arr .> 

Remove* obstacle at <£qu*Bre>. 

14.8 C.lchb*l Vgrlaftjw 

GERM 

The number qt thr ^rrm whose program is berg executed by REPEAT. 
&Rtt>SIZE 

Size of the GEWulLAND grid set by the CRIB Function. 

.HUNGRY 

T ” v Germs sse killed it their foadsupply joes to 0. 

NIL -> A ger|7i h s fopdsuppty is ignored by NJSPEjH". 


GERHLA'ND 


5*rti[jti 14,1 
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7 ■■> Motion tcftfiik borders is permitted. 
jV/L -> Motion across borders It en error. 

The user should never change :WK/IP/WOUND directly, Use STRAP end 
NOW RAP to thence imodes, 


14.9 ImptrmentjTi on 

GERMLAND uses en stray to represent the grid, arid additional arrays for easy 
access to information about a partautsf germ. The individual primitives 6re, lor I he most 
parl„ straightforwardly implamantable, given this data representation. Scire tare is taken 
In Interfacing with (ho slaftderd LlOGO enyiriOnmenl, so that all |he usual debugging 
Features oF LLQGO may be used In the devalopiivnt of gen™ programs, without 
Inletferene* With the display of the grid. 
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Section 15 . Duplay Turlle Primitives 


The display turtle package for Ihe 3-40 and GTflfl is also usable from an ordinary 
LISP as well as from LLOGO Do (FA$LQM TURTLE F>JSL ORE LWCO> to get the 
simple display commands lit* FORWARD, RIGHT, etc. and (FASLOAD OtSPLAY FilSI 
DEK Ll/yCOI for the fancier snap-manipulat ng commands. 

Abbreviations for the following primitives are roted in square brackets. 


15.1 Starting The Pit play 

startoispem fsnj 

Initializes the screen. The turtle is displayed at its home,, the center of the 
screen. This command is also useful for restarting everything when things get fouled uo, 
th* POPS I®?**, etc. ST^RT07SJPt>iy CTW uses the GT40 display rather (han the 340 
display. If you are using the GT4Q as a display for I he LOGO turlle, it must not be logged 
ih To ITS as a consofe. 

NQDISPLAY /JYJJjf 

Says you wanl lo stop using Ihe cl**p'l*^, Flushes the display slave. 

If I he display slave for the PQP-6 dies,, cheek Ihit the run fight is on. M not, stop, id 
reset, deposit 0 in 40 and 41 and Then start. 

l.1$P has three ccmlral characters tor Ihe display: 

AN 


Turns off display. 


aY 


display prinls like Ity. 


Af 


Turns On display for lurtie, assuming » prior call lo STflRrDJSf LAY. 


15.2 The Tunic 

fflrftTEjfiTLE iHTj 

Makes the lurtle disappear^ 
SHOWTURTLE {STJ 

Brings the turtle beck to life. 
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TURTLESTATE 

Returns 0 if the lurtla is not displayed, else return* th* value of ^TURTLE, 
iTVftrUi is the number of the display item which is the current turtle, 

MAKWRTLS <™de> 

The Current turtle is replaced by the picture drawn by ^code*. fravides 
capability to rotate pictures. Subsequent turtle comman-ds, like FORWARD, RfGffT, etc, 
will make the picture drawn by rtode^ move as if rt were the original turtle [triangle]. 

oldtvrtle 

Restores the original LUKSO turtle, 


1S.1 Moving the Turtle 

FORWARD zatpi fFDj 

Moyas the turtle jalaps in the direction it Is currently pointed. 

BACK ztitpi {BK} 

Moves the turtle isteps Opposite to the direction in which it js pointed. 
SE TX ;* 

Moves the turtle to tot YCOFl 
SKIT y 

Moves the turtle to (XCOH. :yS, 

SKTXX ;r tj 

Moves the turtle to (;*, jyl 1 - 

DELX ;dr 

Moves turtle to (XCOS+«Jx t yem 
fUSty :iy 

Moves turtle to fXCOIt, VOfWJ+Ktyt 
DELXY :rfr :dy 

Moves turtle to {ICPR+sfr. yGflfl+jdy), 

JfpJHK fHJ 

Moves turtle home to its starling stale. 
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<4 4 triitnE tht Scmii 

WIPE 

Erases the picture on tha screen. Cues not effect the turtle, Or any snaps. 
WtpECLtRN fWQ 

L'he WIPE, except hides ship* elsd. 

CLEAHSCHEEN fCSf 

Equivalenl 10 B t /P'i£ HOME, 


15.5 Turning thf Turtle 

FIGHT wwte fFTf 

Turns the turtle diocfcwise ranffa degrees. 

LEFT zewgl* [LTJ 

Turns (he turtle counter -clorc.’Kwiso- Lanale dcerces- 
SETHEAD mmrlw 

The turtle it turned to a heeding pt single, 


L5.6 Examining the Turtle's State 

Kdtei The Turtle's home is tC, 0) and a heading pi 0 corresponds 10 pointing straight up. 
The variables :XC0ff, rVCflfi and -.HEADING describe the state at the lurlle in Hosting 
point. These variables should hot he changed explicitly by The user, The fcHwkng 
(unctions relurn components of the turtle’s state rounded to Ihe neHresI integer. 

XCOR 


DuLpuls the X coordinate ol the turtle. 


rooit 


Outputs the V coordinate ot the Turtle. 

HEADING 

Outputs the heading cl Ihe turtle. 

XHOME 

Outputs the X coc r dinilu OF the turtle’s home In absolute scope coordinates h.e. 
relative to lower lott-hend cot nor of the screen) 
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YtlQktt 

Outputs the Y coordinate of the turtle's home in absolute -scope coordinates. 

15.7 The Pe» 

PENDVtPN fPD} 

Pen lowered to paper. Turtle leaves ■ track when m&ved. 

PENUPfPVJ 

Pen raised from paper. Turtle does nOl leave a track when moved, 

PENSTATE 

Returns *1 ■ per up or -1 »• perticwn 

PENSTATE<1 cr^t> 

Sels I he penslats. A common use for this primitive is to make a tub-pr orndurp 
transparent to pen at its, 

PKNP 

T if pan is down, qlse NIL 

HERE 

Outputs {SENTENCE XCOR YCOft HEADING). Useful for remembering location 
via MAKE H P" HERE, 

SETTURTLE ,-Atnfr /SETT / 

Sets the state of the turtle to ^talO- state is a sentence Ol K coordinate., V 
coordinate, and heading.. The heading may be OmiMed, in which case it is not alfected, 

EANGE ip 

Distance Item the turtle's current location to :p. ip is a point specified by a 
sentence of X and Y coordinates. 

REARING :p 

Outputs absolute direction of :p from turtle, 

rrjtr/ifljDs -. p 

Outputs relative direction cn :p Iron* turtle. 
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13.3 Global Navigation 

Piote: These primitives return Floating point il either o J their inputs ere float ng point. 
RASCE r* :jf 

Outputs drslancc ef turtle frOip the point (at, :y>. 

(WAR!Ml ■■% :y 

Outputs absolute direction of {&„ from turtle, fSFriFfirtB (BEARISG i* iy» 
point* th* turtle In the direction ot (a#}, 

TTHFymns a iy 

■Outputs relative direction of (ik, ry) from turtle. ^fifOWT 1 (TOWARDS ;e ;y)) 
points the turtle ifl the direction ot (ni, syj, 

15-g Trignminittg' 

COS! SR :enj il* 

Cosine ot ^ng'o dcgrc#t, 

SfNE jan.flTn' 

Sine ot wangle degrees, 

ATANQENT ;* : T 

Angle whose tangent is 

[SfS, CGS, end AT AS we the corresponding Function* which input 0» output in rad«ens] 

IS JO Teat 
SHOIFT't'Jf'r 

Subsequent printing is mowed on (he screen. Initially, prinling begins ir» (be uppor 
left corner^ 

HIDETEXT 

Subsequent printing is no longer displayed. Text currently on Itw screen remains. 
RRMTRXT 

Any taxi On the screen it «r*Std and Subsequent printing is nol displayed. 

.SHOW 
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A vflriuh-lr whkh is F if printing, is b+,nu displayed, iVf f. il not. Sat by 
SffOBFTfilfr, HIDETKXT+ and REMtKXT. Don’t set it yourself. 

:TEXT 


Variable containing I he number Of tha display item which is the lest displayed by 

SHOWTEXT, etc 

MARK :x 

(TYPE :X> is pieced pt the turn's current locution. SNA? "litle" MARK "leu" 
creates a snap of (ha word ~1e*f. This allows the word to ba manipulated, Le. Moved to 
any part of the- screen, etc. 

. text * home . iftJtry home 

Variables coni air ng coordinates of Isxl to ba displayed on the screen. 
Changeable by user. Initially TE^rJEWOWI- 0., VRXTVHGME- 1000. Thw* art in 
absolute scope coordinates. 


15.11 Manipulating Scenes 

Mote: jFfCTI/KE is the name of the turtle's trick. Does not indi>de any snaps displayed 
via SHOW. SHOW SNAP. ale. iTVRTLE is tha narre of the turtle. :TEXT is tha name of 
■ny teat displayed via SHUWTEXT 

SHOW :ihiw 

iscene is moved 1o I he current position Dl the turtle and displayed. It is not 

copied. 

HIDE racena 

istene hi hidden but not destroyed, 

PHOTO -fc muw- /SNAP/ 

b 

The current picture ia copied a'd named :scana. Any old snap of this name it 
destroyed. 

P/fOn? ■c!i«P /SNAP} 

The pretore drawn by *lioe* is named scene. 

ENTERSNAP “icarta“ 

jPICTT/WIC is rebound to a Fresh display item. The initial state ot this Item hide* 
the turtle. Subsequent commands refer to (hit new i1*m. 

KNfiSNAP 

The original -.PFCTURE is restored. 
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KE&NAF Vcms" 

Sterne is made the currenl picture. The only difference between thi* and 
tfifTERSS/iP "ic-ertc'* is that a new display item is not created!, end Ihe lurlle is not 
hidden. EfUOSNAP iI?q restores the Original iFfCTLi'ftE. 

RESNAP V*m" 

The- picture drawn by *tine’ is added 1o scene. The <line> is execute^ referring 
to the turtle residing in :scene. Subsequent commands will refer to the old turtle. 

PTCTVRE ^dirpJ'e'K »ntjndndi> 

rf'ICftj'fi E «s bound to a new display item while the commands ere executed The 
original rPJCTVKE Is restored following, execution of the cOrnmB'’ds. Similar la SNAP 
"arMe 11 <ceJn:rtifflnrfp> eirttpl th*t W name is given to the new item, hvstead, the number 
Of the item is returned. Thus, Ihe s*n» s!f«1 is achieved byr 

SNAP "ipaiw" <4Marnmea|[i> or 

MAKE H trene" PfGWRE ^Dntmundi^ 

Except that scene is rot added to the list at snaps, 

SHOWSNAP jurejhr 

A copy Of rscene is -dis-p 1 a yed at I he turtle's current position. 

HlDfiSJW mw*w 

All copies of rsr.pnr: are hidden, 


ERASE :»reren 

All copies of scene are destroyed. 


SNAPS 

A list containing all current snaps. 


15.12 Plotter 
PWTTER 

The display is -plotted on a new ptotler page. FITTER will ash If arrays from 
previous plot should bo orasod, The wer should type FES if his preceding plot is 
complete. 

PLOTTER t 

Display p'cited on current plotter page, 

NOPLOT 
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The plotter Is totaled. 


DISPAOH 


Outlino or 7*11 page displayed as :PAGE. 


1514 Pols 
DIALS 

Outputs the vali* of pot a is a <Joci™al fraction between 0 and t. Cartful: |be 
Numbers on Ihr pels are marked in octal,, bul LlOGG normally eypeots decimal numbers as 
input. 


15 14 Points 

[Pomts displayed whether or not Ihe pan is daw«I 

pomt 

Or-p’mys a poml at the turtle's currant location. 
POINT ip 

Displays a pornt at :p. 

POINT ur»p ;p 

Displays a op n” in snap at :p. 

POINT :insp /* :y 

Display:: a pOmt in tsnap at (:*, ry) 


IS.15 Global State of thn Turtle's "World 

Fqr all of thes* functions, the tirst input 'jscew'" is optional, II toft Out, the command 
refers to :P/CTT/fU? by default, 

StTHOMK mtm 

Resets turtle’s home to current position, 

SETHOME :*e*n* rt :y 

Pesets the turtle’s home lo the absolute scope coordinates of <:*, ry), Takes 
effect immediately by moving the currenl iPICTURE to the new tiorr*. IS ET HOME uw*w 
$12. S J !. ■ restores the home to the center of the screen. 

MOTION Jicene 
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Move? :Stena under the control of space console |. Bult&n lerminales 
n*Ov'P'Tient. The new home 15 returned, exoresse-d in* eb$olutc scope coordinates. If thus 
current home Is returned immediately and the spate ww cdnstjle is ignored, check that pH 
switches On the color scope data Switch extension are in the middle position. 


fiM/VK ucene 

filrnks HIM. 

UNBUNK Jieew 

Terminates blinking. 

BRIGHT ;tcm 

Returns current brightness of iscena as a numbor from. 1 (dimmest] to 3 
(brightest 1, Ordinarily tTU'RTEE and iPICTVRE are at maximum brightness. 


BRICUT :>mm iJ’ewJ 

Sets brightnes? pt 3 C 0 ne to :leyol, where devel is an integer From 1 to 6k 
SCAL K jicrhr 

■¥ 

Returns currant serfs &1 ACMHl $cele is an integer from 1 fsfjksderd stale) (0 4 
(16 times standard scale). 

SCALE itetnt :uh 

Sets scai-e of scene to ^ije 3 where ^izo is a*i integer from 1 to 4. :size is a 
multiplicative scale tacldr, Hence, SCALE % doubtes the size of an Ordinary pic lure, 
SCALE J Quadruples >t and SCALE 4 multiplies the size by 3. SCALE I restores picture 
to standard size. This ij a hardware scaling and alFects the current display as well 1 $ 
fulgr# dtspleyege, 


DSCALF .(riin 


The length Cf a turtle step is r«se1 Id :scale. iscale may be any *e*l number, 
Resellirrg the scale with [}$CALE rather thin SC/4LE his the advantage thal the scale 
I actor n**y be any real nurrber. However, BS CALF applies QflSy to future display and not 
Ihe current picture. 
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Section is. thp M«ilt feoTt 


The music bon is a tore generator far Iron ana ta four simultaneous voices, 
having 9 range of five Oclaves. Because ot (h* timesharing environment, music Is 
compiled into a buffer, and than shipped ta the music box all at once, for smooth timing. 
Wherever possible, Ihesp: primitives have brnri trade; cornpatible with both those of 

POP 11 LOGO and PDP 10 CLQGQ. They made be used with the ■■Old* (Minsky) music box. 
Or the "new" (Thornton box c&mpabbi*) musk box. 


16,1 Plugging In 

to plug in the Old music box, tied an EXECUPORT terminal. Pug it into a 300 baud 
ITS l ine, Using I he phono ty pe plug on |h# tap right ol the EXECUTOR! beck, or |h* 
acoustic coupler. Wake sure the terminal is turned off,, and plug the music box into the 
left back ol the EXECUPQRT. {Or lind this all sat up in tha music room on the third lloor.) 
Turn Off I he music box and attached percussron box, and pul the EXECUFDRT switches 
into I he "line" and "uppercase" positions. Tom an the terminal, type r-7, and log into ITS- 
The panic procedure lor the old rnutk box {symptom: keyboard dead but IT6 not down) is 
to switch to local lowercase mode, turn oFf the music box, end type A.. Then type SP, 

lAJh*:n using the music box from MULT 1 C 5 . remember |h?l both carriage relurn and 
line feed musl be typed to end a line, when usir.j an EXECUROFT. The lerminal should be 
in 'half duplex - and "lower case" modes. The panic procedure described above is not 
rncornmendcd, since putting the terminal mlo local mode will have Ihe effect ol logging 
yOu out oF MULTIC 5 . 

bugging in the rew music bax is a bit more of a problem due to limitations of 
present hardware. The critical item is a small piece Of electronics known as the ’Termiftal 
controller card", to be had from General Turtle in Ihe basemen! of Tech Square. This 
card is la be inserted in the correct orientation in port 4 of a Thornton box. <tf you have 
never done this, ask! Pulling it in backwards will burn out the card.) The musk box 
should be plugged into port l, 2 , or 3 , depending upon whtch has th* music box card. {It 
should be labelled.) Then, plug the interlace connector oF Ihe Thorton box into a 300 
baud ITS line, a terminal into port 4 , and lag into ITS. The panic procedure lor the new 
music box is 10 get y&ur terminal to echo " (control *0 space). Since the rvormal print 
routines will actually send ^uparraw for <cafdTol-Q>, this is most easily done with the 
"etho - gadget at Ihe ThorlOn Box, a small connector which makes Ihe Thorlon Box look 
like a full duplex campuler line. (II you want ta make yourself or#, See General Turtle Or 
Mark Miller; you probably won't need it) 


16-2 TbffHrtK On 

Assuming you are plugged in and fogged inlo IT^, you may now run either music 
box in LISP Or LLOtlU LLQGO will ask you il you want tha music baxi if so. i| will ask. you 
which one; if I ha new one, it will ask you which port If it plugged into. Alter answering 
all questions, type START MUSIC. It will tell you to turn on the nusm box (the old One 
will make t lot Ot nOisa), and then type (JK. Then, the noise (if any) will stop, and you 
are ready |o go., LLQGD behaves much like Other LOGOS, and understands Ihe primitives 
below.. 
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The music box can also be ruci from a pur* USP. Type (FAS LOAD HUSIC FASI, 
BSK LIJJGO), and answer the questions. Type f$171ft7 , jlFt&J€} and the fallowing, 
primitives will behave- like USP SU0RS or F£,U0R£, ttf you do K’HflllST’ hacking,, see Mark 
Milter,} 


l-S.S Mllik Primitives 


A f r rrat deal of eFtOrl has gone inlo ensuring upward compatibility with CL.CK30 
amj 11 LOGO. II you have programs far either at these which no longer work on LLOQO, 
please let me know. Nptrce 1 hat many "intermediate" level Femctsons such as CHORUS, 
which had been written in LOGIC code, are supplied aa USP prirmtivos for efficiency. In 
addition, new facilities have been added which should he helpFut. Fn the following, all 
SUth situations have been indicated. Occasionally, a si^le function replaces several 
LOGO functions; the others are sill! available, but may print a message retcmmeriding, the 
newer fund ion lor Mu** code Since mbs! music FuncFiorvs are executed <or effect, 
unless Pi her wise indicated, the value of a function 1 e (Nj atom twordt ? 

BOOM 


fieluros the number which -corresponds to l drum beat. Using DRUM is more 
efficient. No inputs. 

BRUSH <durw.[ion fiii> 

Takes 1 input, a list of efurations. Rays |i.e. stores in the music butFer for the 
current voice} a sequerce of brush notes (see GRJ71CFJ) and rests. A duration of tl 
means I brush followed by n-E Tests, 

CHORUS <farrn f j , ,, . rf(hrm P 

Takes trom One to tour inputs, which should be forms [procedures with 
arguments, or const antij CHORUS evaluates each aftUme-nt in turn, and then goes Oh to 
the next vertce„ in cyclic Order, end evaluates the next argument. Example: 

HIHORUS SJW 1 SO SING $ ft) SINC % JO 

if the number of inputs is the same as j.WGICES, sequential calls 1o CfJQHf S or 
SING will do the expected thing; if Ihe number of voices used by the &*£ument& is equal 
to zWOICRS, recursive calls Will also work. For other situations, just remember that 
tVQlCK is updated alter evatuating etch argument- For example, if INVOICES ■ 3 and 
you CHORUS two calls to SING, the mmt call to CHORUS will at Fed voice 3. 

CHORUS! t> <fvrm J> 

Version of CHORUS which takes exactly two arguments. For upward 
compatibility Only, 

C IIQRUS3 <farm {> s/firm c/arpi V' 

Analogous to CHQRUS1.. 
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CJTOffi/5f */arm /> </artti J> </orm < /<. i r.'n +> 

Analo&Ous to CHQRI/$3. 

DRUM *liit &/ duriii^nj 7 

Analogous to BRUSH To* drum rotes (see BOOM). 

CRtTCH 

Returns the number carrespondirg lo Iha brush sflund of Ihe percussion speaker. 
More eftic e-it (0 use li Jf£/S H. 

jM AKETUNE <tnnc neme> 

Takes as input a nemo, Mkft LOGO WflKF or LISP SEr, It multi planet the huffer 
and saves it as I he 'thing" of the name. Thai is, it stores Ihe l une as da I a, as opposed to 
procedures. This allows faster playir^ {see H/iVfl and easy storage (.Jj'TFEd with 
other LOGO variables.) Since MAKRTUNE does not dear the butler, allows sarvirng, and 
playing incrementally larger portions ot a long piece. Tunes made on one musk ban can 
be played on the other F wilh the exception that tunes With CKactly thrco voices can 
never be played on the no* music bp* (see NVOICES). HAKETUNE drd not exist in 
CLOGO or 3 L LOGO. 

MBUFCLEAR 

-Mo Inputs, doers Ihe music butler, and starts at voice [. This should be dpne tor 
e* ample, afler typing *C to fcili an unpleasant song, or after M AftETUNEtng tN» linii 
version oi a song, before starting a new one. 

MEUFCOUNT 

Same as ELEN. 

MRUFfMT 

No-Op, Prints message to let you know you tried to use this relic of the past. 
HBUFSEXT 

ItHlpL ts «j MBUFMin 
MRUFPUT 

NOH 3 P. (See MBVFINIT) 

M BfJFQUT 

tio inputs. Plays the music buffer. Does not clear it. 

MGLEAft 

Sttne as MBUFGLEAR. 
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Returns the duration oi the rf'CJJ'Ci' created so far (since the last 

Nlil/FLKftR). Uselul tor building procedures such as percussion iccompeninortts tor 
arbitrary length tunes, (see VLEN, 

NODHUSlC <T or JVJiA 

Ta>-cs one input, NIL or Otherwise. It non-Aflf,, puts music in a mode where 
numbering is from 0 to 59., and note 60. is the same as note 0. (i.e., (note mod 6C!i), no 
that one ntHitf not Wpr|-y about exceeding th* range of the music bO!f, 

NEW HUSfC 

No inputs. ^F^m* system that you with to use the new music bo* Ash* which 
port music bo* is plugged into. Normally user will not reed to call .VFW MUSIC, as the 
questionnaire et toad time sutt ees, See: OLDHUSIC, 

muvsic 

No-op. See MBUFM/F. This function may be reinstated as a wjy to enciss Ihe 
music package,. For euample, when one wants to Foad the turtle package instead. 

NOTE < pitch J ‘ 

Unfurtunalety, (through no taurt Of UQGO^ there ere minor variations between 
I1LOOO and CLQGO. The difference between NOTE and SINC Is Or* such probteh*. 
According to LOGO memo 7 (S/10/73), iWT£ Is the basic 31 LOGO music command. It 
takes two inputs, a pitch and a dural ion. II numbers pitchea chrumalically From -24, to 
36. with 0 being middle 0. There »r* also three special pitches, as follows; 

-23, is a rest 
-27, is a boom 
-26. is a gritch 
-£5. is illegal. 

+ 

11 LOGO NOTE can also take multiple inputs. LLOGQ music has implemented all ol this for 
NOTE, except the multiple inputs. The numbering fs slightly ditferent from CLQEjO SING, 
which is elso implemented in LLOGG, (ceo: 

NVQICF,$ <U 2 „ 3, or 4> 

Takes One input, hooeMly a number between 1 and 4. Srls iftfPOFCFS to that 
number, dears the buffer, and sets rPflfCli to 1. Remember lhat 3 voices is illegal on the 
new music system, and will generate an error. It is generally better to use tour voices, 
one blank, so that tunes will play on either music bo*. Fn WO’O.WE-'SfC T mode, (normally 
not the case), Celling iWCtJfJK,^ with a number outside oF '’/*.] will not cause an error, 
but seems crazy. The j> input mod 4 will be used instead. -S^fing nYVtF/CES or 
M/MEng "NVtifCES" cannot be prevented, but is considered a feus pas. Accessing 
-.NVOSCES is welcomed, Calls W£ffj'f'CLIFi4ft and r«ets rt'OJC^ to 1, See: rWOfCftS, 
:IWC£. VOICES, MODHUSIC. 

OLDMVSIC 
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No inputs, Puts system rrt mode for Old rrareic box. Norrrulty nol needed by user, 
PS questionnaire it lend time suffices. Might be used, for example, if you made- a mlthfeo 
answering Ihe questions. Bee; NEtTMUSIC. 

PERFORM f.'Uhmillion PHI 

No inputs. Outputs the music buFler, and I hen dues en MRVFGLEAE. See: 
MBUfObT, W MJfCLLAF, PLAY TUNE 

rumvm 


TpHes One inpot. which must evaluate to a tune pealed by W/JM’EIX'iVB. It plays 
Ihe lune. Does not clear or otherwise alter the current music buFler, PLAYTUNE Is 
transpare-nf to Ihe current number of voices, evpn il |h* time uses a different number. 
£e«: HAKETVNE. PM. 

PEST 


No inputs. Returns the number at the note which generates 5 ,| cntc c . n "hr- musir 
bdif. (Like BOOM in d CRiTCS-i, this will win independently of whether El LOGO or CLOG0 
primitives are being used; likewise, il will be Ihe correct number for MOJMft‘.SI r C T Or 
normal slate, even for different sealebases.} Naturally this checking fs less efficient Shan 
jus! calling SIN C -25., or NfTTE -25. Tdr She appropriate duration. See: 5J|VC, NOTF, t 
MQDMUSfC, SCALES ASE- 

RtSTARTUVSK 

No inputs. Like ST’/JJtFWtj'S/C^ eacept re-initiahzes all system variables, and runa 
questionnaire as far back as asking which musk bo*. Useful in situations of total loss 
after panic procedure, Usually tunes created by MAKETi/NE, and user procedures will 
be intact. Buffer will be wiped out. In eases of peculiar behavior at login Or load time, 
guarantees that everybody thinks They hive the device you Think I hey do. If this does 
not work, go to PLUGGING |IT. 


SING <pilr.k> ^UMlu-jir 

Basic CLOGO and (.LOGO musk command, takes IwO inputs, a pitch number, and a 
duration. It is highly recommended that durations bo integers greater than 01 Very large 
durations (each unit corresponds 1o a character atom in LISP) are apt to slow down Ihe 
system a lot, so small integers ?re highly advised. Pitches are from -25. to 39., with 0 
being middle C. LLt-jt see the remarks about ULODCs variant, NOTH, and also 
:5Cyif,KHfl5E and ffOOMt'S/CJ Pitch -25. it a rest, -24. a bosm, -23. a gritch, -22. 
ignored 1 . (Bui see PEST, BOOM* GMTCli) Djrations are normally broken down into N-l 
heats oF pitch and 1 heat of rest, to avoid slurring the music. However, f I Fie SPECIAL 
variable ANSTRL'HENT is "ST/fCCfl-TTr, I beal □! note followed by N-L beats Of reel 
wiH be sung, (i.e^ stored in the music bulTor under the current voice}. IF ether phrasing 
is detirtd, it may be added laler. 

SONG <p£icflei> <dcrciwiip 

Takes lwb inputs, a list 01 pitches md a list pl durations. Cells SiNG, pairing 
pilches with durations until thi shorlor list is exhausted. In other LOQX this was not a 
primitive, but was written as a recursive LOGO procedure. 
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sr/umurarc 

'Jo inputs. Should be called lo turn on the irtre-ic box. Unlike CLOGO, it pauses to 
lei yog I urn on the bb» 3 tp miniirn« the unpleasant npis* generation on the aid music 
box. (PERFORM alone will suffice). Clears IN musk; buffer end sets iVOJCfc" 10 1. 
Probably unnecessary with new music box. 

VLEN 


No inputs. Relurns durafan of currant buffer $#*: MBVFCjQVWT, MAX, 
MLEiV. Useful when chorusing a lune with an accompaniment. It the accompaniment is 
tte? I«t argumenl 1b Cf/G-FUS *nd contains a stop rule ilhe, 

IF VLEX - MLEIV THE!* STOP 

the accompaniment can be ured with arbitrarily long tvnfri. 

I'OfCE 

Sets :[ r CiTCP lo its one input, provided thai input is a positive Integer less than 
If greater than the current number of vCHces, iVtWGIiS k CiHed to increase- the number. 
AH music from now until Ihe next till to VOICE (p * a primitive like CffOWS which calls 
VOICE) will go into this voice. Alt the voices n use will be multiplexed' prior to 
FEKFUFMing the buffer. In MGBMCi'S/C T mo* inputs greater (ban d. do not cause 
errors, but are simply cycled through Ihe allowed voices. WvlKEng (LLOGOI Or SfcTing 
(L15P> rFOfCE k not nice. 

H)/C£5 


"No-op. See SOMUSIC If anyone his l use for this which is reasonable, e.g^ 
synonym for NVfllCRS, I will be glad lo implement it. 

-INSTRUMENT 

Speclat system variable which is user settable. Its value determines the behavior 
Of NOTE and SfNG as above. Qjrrenl meaningful modes art LEGATO and 5T>KCrfTO- 
Amythlng else it considered STACCATO for now. 

:M4X 


This pseudo variable is actually a call to Mt.EN, above. II exkls Tor compatibility 
with CLOGO- 

’JWOfCES 

Special system variable, no I to be changed except by Calling WOfCKS". If tells 
you the number of voices being lilted or played at present. Default is 2. 

:VO!CE 


Special system variable, to be changed only by calling TOfCl?. Tells you (ha 
current voice that Is bei-g lilted. MEIiFCLEAR resets lo 1. Always initialized to 1, Gan 
be changed by call to CTfCIfttfS. 
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.SQALEBASE 

Special system variable arhith may he changed by user. Pt tells the offset IrCrn 
middle C to be used in renumbering notes lb Ones teste, Default Is «ro. 
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11 LOGO 2,11,13,37 

11I0GO iAer's manual- 13,37 

340 14,33,47 

Abbreviation 19, £2,23 
altmode 13 
ambiguity 13 
Ang’e brackets 13 
APL 3 

arithmetic 3, 13,1? 

ARPATCT 33 
Array 1, J6 
ASCII 3 
associativity It 

SBCP 28 

brackets 35 

breakpoint 30, 3J, 25 

buried procedures 21,22,23,30 

canned teop 4 

carriage return 7, 3, 13, 20, 24, 35, 36, 39, 4t 

Character display 1, 14, 41 

character synta* 3 

aOGO 43, 4,5, H, 1% IS 

CMU 40 

colon 36 

cOmmiritt 36 

tanparison 16, 17 

caTpite 22, 30 

Conditionals 4,5 

OONWVER 1„ 5 

Control character ]3, 20, Z 1, 34^ 33, 40 
eonttol structure 4,31 
conlrol-itaign 25 

DATAPDiNT terminals 14 
detining 5,14,20 
devtea 32 
devices 3 
di rettery 32,38 
Disparity 2 
dollar 35 
dotted pair 3, 8 
double quote 34,36 
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edit 'mode 20 

Editing 3, 9 P 10, \i, 2£> a 35 a 40 
Eng is h 2, 4, € 
error handling 24, 34 

err&r interrupt 25 

error interrupt hi molars 10 
error messages 9, IQ 
*v*lu*tpr 9 
exc J aim alien points 36 
ejrponcnMion 17 

file spetEfitatipn 32,38 
fired point 1, 3, 4, 37 

Fionti"g pOinl 1 

food supply 43 
Iraotron 3 

lunctioM arguments 15 

girba£* tpIb^lOr 28 
generation 43 

CERMlAAQ 11,14,36,40,41 

global variables 23 
GI40 11, J 4,38, 47 

heeding 42 
homonyms 6,9,18,19 
How To Del On the System 13 
hungry 43 

IBM 2741 39 

identifier* 0 
implementation 3.12 
mlie 5,3,9,16,17,(8 
■nilialifetiQn Me ]4, 33, 40 
inputs 5,6,9,23 
faterrm LIS P User 1 * Guide 13 
interning 3,1! 

Interrupt 1,21,35,40 

line number 3, 4, 6, 9* 3t 
Line oriented input 7 
line-oriented LISP reader 9 
link 33 
lists 2 

log.t 6, 16, 17. 35 
login 13 
logout 15 

MACLISP Reference Manual ($, 3$ 

frtinus sign 10 

mistyping 10 

mnemonic 3, 4 

UULTICS 12,13.30,32, 38,39 

music 3, U t 14, 34, 38, 40 
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N*tgf lines? 2 
negative number IB 
NLL0G3 14 
noise words 4, 5 

Obarrjy B 

obitirln 42 

cutpul 35 

par*nl-heses 5, 7, 9, 16, 36 
paffser 5,9,16,13,19,28 

psriif^ property 9 
plfhnamB 3-B 
POP-6 11,47 
Percent sign 36 
Pt4WtR 1, B 
precedence 16,17 
preFin 5, 9, 16, IB 
preFty print 4 
prrmitiue? fl, 9, 22, 30,34 
printing 9, ]0 
pfOgT^m term 3 
program underfitindtri 9 
promote* 20, 41 

Properly list 1, 9, t% 3$ 
pure |J 

•r^atder 3 
Feadtib’e 9 
recursion 1,2 
roundoff 4 
ru*Put 21, 35 
run (ime artor 30, 24 

Sell-modifying, procedures 31 

set cc Dn 36 

sentences 2 

sharp sign 25, 29, 36 

side efletls 2B 

Simplicity 2 

single character object 8 

single quO-te 34 

si ze 11 

snap 4? 

speed 9, II 

slack 30,26,23 

siring 11, 35 

CUper-pfOcedure Iree 10 

TEIM50 12, 22, 40 
TENEX 12 
Thcwnton bdK S 6 
TN6 39 
top level 29,3$ 
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lutlU S, Ll, 14,21,38,40,47 

lype Ehectu-nj 9, 10 

I y(nng errors 20 

uriparj^f 10, IS 

virkablK 6,21,29,33 
wards 2 

wrong nurnbir Ot mpuls 23 
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A\ 

41,42 


a4 

25 


aC 

40 


a£ 

20 


aP 

47 


aC 

14,30, 40, 53 

aN 

26 


ajv 

47 


aP 

21 


Afl 

20 


AS 

21 


aT 

36 


aEF 

33 


AJf 

14 


aV 

47 


aZ 

E3, 56 


JF 

25, 27 


CAREFUL 

IB 

COMPILED 

30 

CONTENTS 

30 

iEDITMOOE 

20 


EMPTY 36 
EMFTYW 36 
ERRRREAX. 24, 26 
C£fiW 45 
-CHWsir.ti « 
HE/itilSG 49 
HVNGRV 45 
/JVF/Jf 1# 
^(VST’FfEVjH^AT 61 
USPfiMAX 26 
M/IJT 61 
NVOICES 61 
S CALEBQSE 62 
SHOW 51 
S.V^PS 53 
roriJffJME 52 
TEXTV NOME 52 
TVflTXE 43 
POfCfc 61 
ITR7IP£fl0L™ 46 
lOCHU 49 
YCOf t 44 
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ABBREVIATE 19 
ACCESS {RLE 44 
AND 4, 5, 17 
ARRAY 37 
ASCII 36 
ASSOCIATE 17 
TTANGENT 51 

BACK 44, 43 
BEARING 50 
RE 44,45 
BUNK 55 
ROOM 57 
BOTH 5,17 
25 

BRIGHT 55 
BRUSH 57 
BSfM 45 
CL'C 15,40 
BL'flT 33 
BUTF1RST t 3,4 
BIT LAST 2 

CrlJ? 2,3, 4 
OJTCJJ 25 
CEff 2, 3, 4, 36 
CflORMS 57 
CHORVS2 57 
CtfOTHAS.I 57 
CH0W54 5E 
CLEARSCftEEN 49 
CO 27 

COMPILE 30,33,40 
CONS 3, n 
CONTINUE 24, 25, 26, 27 
COSINE 51 
CS 49 


DECLARE 30 
Ml* 43 
DJflKF 48 
Mir 43 
OESrmXT 45 
DMU 54 
DISPAGE 54 
DfSPi/ir 19 
DO 4, 19 
DOWN 25, t% 
DRL'fl 53 
DSCfltE 55 
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EfiSTP 41 

EAT 13 
Eiiir 10, 23 
EDtTUNE 20 
EDTTTITLE 20, 2B 
EITHER 5, {7 
END 20 
ENDSNAP 52 
ENTERSNAP 52 
EQUAL 5 

ERASE 19, 22. 23, 33, 53 
EVALFRAME 10 
EXFT 27 
EXPLODE 36 

FALSE 6,35 
F 0 41, IS 

flLLFOQD 13 
FIRST 2,3,1 
EWS H COMPILED 30 

FWSII INTERPRETED 30 
FOOD 13 
FQODP 13 
FOODSUPPLY 44 
FORWARD 14,45 
PROMT 15 
F$fDR 45 

GERM 51 
GERM DEMOS 41 
CRT 19 
GETSQUARE 43 
<70 4.5 

COO’DFfVfi J5 
GRID 4 2 
CRIDP 42 

H 40 

HEADING 41,49 
HERE SO 
HIDE 52 
HIDESMAP 53 

HI DETEXT SI 
If t DETURTLE 17 

HOME IE, 49 
IIT 47 

IF 5,17 
IFFAfSE 4,37 
IFTRUE 4,37 
Wf I 17, 18 
IttSEFTUME 37 
/S 5 
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KILL 44 

LAST 2, IS 
LEFT 45,49 
LEFTSIDE 45 
im L L 35 
UNEP SINT 22,40 

IJSPHflK^K 25,2? 
LIST 15 
i.i.om (INIT) 14 
VOCAL 37 

wcoreeak 25 , 26,27 

LOGOUT 40 
LSIfJi 1 45 
LT 45,49 

MAKE 17, 32, 36 
MAKETUNE 50 
MAKTVRTLE 4S 
UAFCAR 4 
MARK 52 
MBUFCLEAR 50 
MBUFGOVNT 58 
MRtjFINIT 50 
JMflWFJVEXr 58 
MWJFOUT 58 
HBUFPUT 5$ 

MCLEAR 53 
tfjrfjV 59 
M0O Ml/Jf fC 59 
MOTION 54 
MOVE 42 

NEW MUSIC 50 

JYBJfcT 44 
JVfi &„ 35, 36 
JWJIJSPMP 47 
NOMUStC 59 
WPWr 53 
mPRECEBENCE 10 
NORTHP 44 
WOT 17 
NOTE 59 
NOWRAP 42,46 
JW0/GE5 59 

OBSTIBJCF 45 
OLOMLiSlC 59 
OLBTWRTLE 48 
OK 4,5,17 
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PAUSE 25 
PJ1 50 
PENDOtFN 50 
PENP 50 
PENSTATE 50 
PRNUP 50 
PERFORM 50 
PHOTO 52 
PICTURE 53 
PLAYTUM 60 

PIjOTTER 53 
Pti/JVT 54 
PRECEDENCE 17 
PRliVT IB 
PHfiVnWfT.'V 27 
PPliVrePIO 42 

PR!IVTOUT 6,19,20,21, 22,32, 33,40 
FRtNTUP 26 
PflOC 9,37 
PU 50 

FUfSPUriftK 43 

fl/IATDOjtf lfi, 37 
HflJVCE 50 
READ 19 

READFJLE 19, M, 33 
RK/lfl 45 
REU$pt/dRfc 43 
flEJwrExr 5] 

REPEAT 41 
RESNAP 53 
REST GQ 
RESTART.** ISSJC 60 
RtCHT 45, 49 
R fCHTSWR 45 

H0UJY0OFF 37 
RSIDE 45 
RT 45,49 
fl[AV ig 
Rl/NKHTM 41 

SrfPE 13,32,33 
SCALE 55 
SD 47 
$ETHEA(! 49 
SETHOME 54 
SLIT 50 
SETWRTLE 50 
SLTJf 4B 
SETXY 4B 
sett 4S 

SfJOFT 52 
SHGW$1VAP 53 
SffOEFT’KKT’ 51, 52 


Lndrs in IUIHJ PrimUivn 


IISP LOGO MEMO 


Tb^e 72 


Jure 27, 1374 


SfWWWRTLE 47 
SINE 51 
SING «0 
SONG 60 
SOUTHP HA 

SPECIAL 30 
57 37 

STARTDI$Pl.AY 19 r A7 
ST/tRTMUSIC 61 
STEP A2 
STORE 37 
St/H 6 

T 35 

TEST A, 17, 37 
TEXT 36 
THEN 4,6 
THROW 25 
rn 4, 5, 20, 22 
TQPCKRM 4E 
TQVCfl 45 
TW4R0S SO 
TRACE E O’, 23, 2^ 

TRUE 35 
TURTtrEST/tTR 40 
7T PE 52 

UNRf.INK 55 
UNGRID 41 
U'NSFEUAL 30 
UP 26, 27, 2E 
USE 33 

USER-P AREN 10 

VOICE 61 
VOICES 61 

PTC 49 
WEST? AH 
WHAT 43 
WHERE 44 
WIPE 49 
WIPECLEAN 49 
WRAP 42,46 
WRITE 32,33 

X COR 49 
JtMOWE 49 

rajft 49 
rHQME 50 
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TV$1ZE 

Returns a list containing the ho-fizOnlal and vertical sires ol Ihe d splay area in fester 
pomls. The default site is 300 n 300. Thft dimensions of the entire TV screen w* ^55 ^trlicek] x 
576 [hcfijonUIJ, 

fTSfilfi ^niitJiNM 

Sets both the horizontal aod vertical sizes cl the cJiSulay area to Modifying Ihe 

71? SIZE ceus.ec e CLE/iRSLREEN 1o be performed. The size ol I he area al the tirvfto-n of the screen 
tor typairs and typeOut is adjuslad Id take up as much space as possible on the scream not being 
used for graphic output. Chang ng the TVSfZF wrll not riu« any effect on pkturos previously saved 
by MAKEWiMMJlF [see Sect inn I7.I&J 


TVSIZF <jipm-y-dnT> 

Sets the horizontal and vertical sizes independently. |l either ol the two inputs is NIL, the 
corresponding slie remain* unchanged. 

rURTLESiZF, 

Returns a list cantainmg 1 he horizontal and verticil si?#* of the display area In turtle 
coordinates, These are in lloating paint. The initial default it EC0O ir 1000, and the Origin it always it 
Ihn center Of the screen — so turtle coordinates initially range from -500 la *500. If wraparound 
mode is in effect, turtle coordinates are allowed above and below Ihe range set by TVRTLEStZE, 
and will be mapped to appropriate points On the screen. 

TVtiTLESIZE 

$el$ thn dimensions of 1 he? screen in turtle coordinate^ to turtle slept, If the 

display are* is nol square [Thai ls t if thfl hpriaontal and vertical Tv si;c p|r*imjl*rs are not equal], 
then dstt-iiuz is taken fo be the number cf turtle sleps for Ihe minimum dimension oF the screen, 
and the other dimension ■* adjusted accord ngly, In particular, you cant specify Tt!RTLE$IZE 
independently in each directrun, sn that a turtle step always correspond* to the **me number of TV 
points. Changing TURTLKStZH has no el feet On the picture currently being displayed, or on any 
pictures saved by MflKElFINDOIF. 

SETHOME jn.'ffrLf;f/C7MK} 


SET HOME <IWPD-I-Anm<r> <nnin-y-ftnjpp> [T"lf| 

Changes the origin of turtle coordinates to the specified location, defaulting to the turtle's 
present position. That position on the screen will then correspond To an AOt)H and IfCOfT &f zero lor 
all subsequent lurtle commands. The home location is local to each turtle, SO that oath of several 
Eurlles may be assigned different homes tin the screen. 


H. 

17.15 Screen Color 


The Knight terminals h*vo a facility for easily changing whether this which are On in I ho TV 
memory will be displayed as dark or light on the user'* screen. fly analogy with a photograph, ip 
"negalive" made, poinls which are on [graphics and ted] will be displayed as light on a dark 
background. Eh "positive' 1 mode, they arc displayed as dark Oh a light background. The current slate 
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of 9 user's terminal tan be complemented by typing ^ESO C, The following f*intt<on* allow II te toe 
examine-d- and controlled by a user program. 

aHJomrm [CLsrf 

r iff She user is in ^positive" mode, NIL if in '’negative" mode, 

COWRNEGATIVE [CLNj 

Puls She User m negative- mode, l.t, lighl te*l and line* on • d-irk background, Thi* is I he 
mode in effect initially al login lime. 

CQ LQRPQSITIV K JCEPj 

Put* the user in positive moctei dark terl and pictures bn a light background. 

COWRSWtTCft JCLtifT] 

Complements the GO iXlRSTATE', if (he current mode is negative, switches to positive mode, 
or vice verse. This has the same e Fleet as typing <KSC-- C on the terminal. 


1?-I6 Saving Pictjjfes 

In creating. pictures which eonsitt of repeating patterns oF smaller picture*, arid creeling 
animated cartoons., it s often useful to be able lb save displayed pictures d^ewn by a series Of 
IurMe commands, end operate upon them as a unit, displaying and erasing them, moving them to 
Other parti pi thb ttreen, etc, The LLOGO TV turtle provide? such * facility, allowing the user to 
save reel angular porlions of the screen as arrays b( paints. These arrays can be displayed and 
erased at any location bn the Screen, although Ihey cannot be automatically rotated. 

This facility it somewhat different (rom the SNAP torrunand in th* LLOGO 330 turtle and 
1 iLQGQ, The SNAP Operation saves the picture at display lists, essentially a vector representation, 
while the TV turtle window saves an array Ot poinls. For large, sparse prclures. She vector 
representation leas space, while the paint array represenlalion favor* small, complex 

pictures. Saving point arrays makes it possible to redisplay pictures much more rapidly than 
redrawing them with (he commands Used to originally generate the pattur*, iinfb retOmputatiOh of 
paint* lying along vectors is unnecessary. El is thereFore ideal for programs which want to make only 
few, r.p.itially localised changes to a picture, hoi need Ihe maximum, possible speed for dynamic 
updating of ihe screen. M also has the advantage that I ha amount OF space and lime used for 
creating and redisplaying pictures is insensilive to the complexity of a picture within an area. These 
characteristics make an array representation more suitable than a vector representation far, say, b 
S pace war programs where thb ipa::e ship must be redisplayed rapidly, md consists of perhaps 1 
large number of vectors cbnFined to a small area of tea screen. It il*a provides a "’clipping" facility. 

Saving point array* b*s a property not shared by LLOQO’s SNAP lor the 330 ■— “What you 
see is what you gel". Everything within Ihe designated area is included, regardless of how it was 
Caused to appear — vector*, text, point*, other WfNDOWt, etc. This mean* that you can always toll 
whet will be included in- a saved picture simply by looking at the screen. 
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*wfnrfoie-name- 1 <bm> [.AHFj 

CinaFe-r; A “window", it., an array Ql point;, and nors it ^ui[ndoir-Finmn>. The <i«i)iisrDB>- 
nnjna> should be- a word, and should tw chosen so as no I to conhict with existing Functions Or 
arrays. The window is centered on the turtle 1 ; current location, and extendi tor <jirn> turtle slap; 
horizontally and vertically Fron the center. The local ion ci I he center OF the window and its size are 
r*nw«l»r*d. 

M/lKEWINDDftf rwlndiiifMjnf 1 '-'huriitimi tiM> <nnrika^rFra> 

Creates a window centered On the turtle's current location, but sets the horizontal and 
vertical size; Of the window independently, so the area saved can be rectangular instead of squire, 
a; in the one input mode. 

M flKRIFIWDQW ^winJaie-nomr^ <ceater^y> ^eritenfflf-me^ * vesticaJ'-jiie? 

Creates a window centered an the spedFied local ion, of I he specified size. If the ^twrtfcaf- 
wae> is Olwltcrd it Is assumed Identical to the ^ariiartaf-ju^, 

tZRflSRfFlNDOIF <jnnJnui-jinjrni> {.EFF? 

Destroys the window specified hy smrni(]|D-narpqi!\ ]f the window it no longer needed, Ihl* 
permits the spate that II occupied to be reclaimed. 

EftASEWiNDOW$ S-PFF5S 

Erase; all turrently defined window;, 

.wiNtfOirs 

Global variable which contains p tjst of all currently defined windows. 

IFINDQfFFR/ME „.„ h [IFF3 

Takes inputs Irke MAkEWI\DQtF f except for the window name, That is, it take; frpm one 
to four inputs specifying a size and Optionally a center fOcalidn. \FINDOWFR/IMK displays a box On 
the screen, which instates the extent of the picture wl»th would bo Saved by a M/iKKWIftDGtP of 
Ihp corresponding size arvd location. This is useful in dec dkg how large a window is necessary 
before using ,W AKKIFf\D()ir. The box is XQRed ml? |he screen, ;o that giving the 
1 .VfJfJIF FHA ,W K command again will cause the box to disappear, If no inputs are given Id 
IFfNDOIF FRAME the size and location default to the list one; ;pot!f!*dL 

SflCIB^iF/iVfjpjF *.jcind’oir-rirti7in> [,?(FJ 

Causes the specified window to be displayed at the location at which it was originally 
Created. Currently, wraparound is hot allowed; display Ol the picture is not allowed TO t-rOss the edge 
of She display area, ^hanging TV$I7^R and nVfi77.ES/2K hav# no «lf*et on (he sir* of ;*vad 
pictures. 
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SHOW WINDOW <winjavt-niim#> <n*w-r.iwt«r-i* t.nnu-™nmr-j4- 

Causes the window to be displayed at the new location specified. 

HiflRWlNItQW .... {HEFJ 

Accepts arguments like .'ifff)tFiFfJVO(?EF, but displays the window turning off any point 
which weE On In the window when it was created. The e fie cl of this is as il the picture were 
redrawn in eraser mode, If 9 call to SHOWWINOOW displayed the window On a blank area,, a 
similar call to HIDEWINDOW will erase it. If SltOWWINDOW superimposed the window on 
something »lm»dy displayed, the aid picture is nOl guaranteed to remain intact after the window is 
hidden. 

xqrwinww _ [xir] 

Like SHOWWilWOW and HIDEWINDOW, but XOft’s the picture into the screen. 

WINDOW HOME {Wit} 

WINDOW HOME ^mind'Diirninr^ <Nru't^iiHU> cmus-y^Ae me> 

Changes the home local ion associated with a wmdow to lhe specified location^ defaulting to 
This is the ideation where the center of the window will be displayed it only the name of the 
window is given as input to MlOW WINDOW, HIDEWINDOW, ek. 

STIlfEirfWflOFFS {SPFS} 

Creates a tile on the disk which saves all- currently defined wihdOwS in binary. They Can be 
reloaded at a taler bras with CETW ENDOWS. The tile specification follows the tamo format Os Other 
LLQQO file commands such *± PS/\DFILE, and USP*e UHE/ID. The filenames are not evaluated 

CETWINDOWS {G&Fj 

PelOads windows from a dasik File created 1 by SyAVKWI NDOWS- 


17-17 Printing Picture* on the XC-P 

Pictures drawn with the U.C ! jO TV turtle may be printed On the A] Lab's Kero* Graphic* 
Printer Id obtain hard copy. The following primitive creates a file which can be prinlad by |he XGP 
control program ?CRiM p . 

j£(JP runted 

Creates a file saving 1 he picture in the designated area of the screen. The file can then be 
printed on the XGP. The file specification follows the same formal as Other LLDQO tile commands — 
from one to lour words. A rectangular area limiting the picture i*Y*d is SpecHied in the sans format 
accepted by the window cot "rands — from one to four numbers. If omitted, Ihe area defaults to the 
entire screen. E* ampin: 

Jf CP PICTURE > 200 .iop mo 

saves the picture extending for ICO turtle steps horizontally and vertically from the point <£ 00 , 300 ) 
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fn the file P3CTURE > on the ctrrrenf directory, Caplions can be printed On the screen using. tine 
MARK command and will appear on thwfr printed picture. The pictures wilt bo approximately the mns 
size as they appear Or> I he TV screen. Currently picture? saved ere Heated to 300 by -MO TV points. 

Two warnings concerning XGP pictures,: Firsts the KGP has a problem common to all 
machine's — an inability to reproduce large black region. An attempt to priM a picture- with areas 
tilled in biach will cause the black regions to "white out', Pictures created by using, the SUflDt .i 
command to shade regions with dense pal terns wilt not be printed correctly Oh the KGP, Also, it is 
best to try to limit the area ol the screen saved to as smalt an area as possible. Since picture tiles 
must be Output to the XGP last enough to insure that Ona tine is printed before the next Or 4 is react, 
targe files may lose when the system is crowded. The symptom of this sort of lossage is blank 
horizontal bands in the middle of the picture. More efficient XGP commands to be implemented sQOn 
will reduce the likelihood of this sort of Icnuft, Images on (he TV screen drawn by the TV turtle 
cart also be printed using the Tektronix hard copy machine-. 


ins Shading 

A unique advantage of the TV display* over vector oriented displays is that in addition to 
the display ot line drawings, they make feasible the creation ol pictures using shaded areas. 
Patterns of points ol varying densities can be used to fill regions, cresting the effect of a 'gr*y 
scale". The TV turtle's shading facility is aimed toward creating a convenient and efficient means of 
specifying areas to be shaded, and patterns to be used in shading. The basic idea is that regions to 
be shaded are indicated by drawing a dosed curve around them in PEf'fJXf IF/V mode, and placing the 
turtle inside the |-e|jrOn before issuing the Sit/.ittH command, with an argument determining the 
pattern to be used Several simple patterns are supplied by the system, but the user has the 
Opportunity ol defining rew ones. 

SHADE vpittim n«jn#-> 

Shades Ihc area enclosing the turtle"* current location. The input is a pattern to be used in 
shading the area, and defaults fo the SOUD pattern if omitted, The turtle mutt be sitting in an 
Empty area [not on a line or in a filled in region], or an error resulls. The efFect ol this primitive is 
to fill in the ration surrounding the turtle’s location with the shading pattern given [by inclusive 
ORing it in with the existing pictureJ The region to be shaded must be bounded by a ctoced curve: 
SHADE works by filling in the pattern starting From the turtle’s location, and stopping when a 
boundary r$ reached. If the teg on is not closed, the enlire screen will be shaded! 


17-19 Shading Palleriui 

Shading patterns are represented as functions which tell the SHADE primitive haw to 
shade an area. The system provides a group Of predefined shading patterns, described below. These 
will probably bo sufficient for most simple uses at shading, i.s. distinguishing a few neighboring 
regions with diFlerent shading patterns, bFc. Those needing more sophisticated capabilities Can define 
their own patterns, The predefined shading patterns currently available are: 

% 

SOUD 


A shading pattern which fillis in every point. This pit tern is the deleult used if no argument 
Is given to SHADE. 
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CHECKER 

A pit torn which fills, in every gther poinl, h thtcUrbOirdi flthion. 
HORTZLINES 

A pattern consisting OF hpr zpp|?l lines. alternating light and darlv. 
VEKTLlNES 

Lihe HURfZLfSES, except Fines are verlitll. 


CRiD 

Both hcrizorta 1 ' and vertical lines, superimposed. 

Texture 

A pattern which turns on points randomly, creating a texture like elfect. An average of tiilf 
the points will bo turned on, 

0ARKTEXTURE 


LiCffTTEiTVRE 

LlKe TEXTURE, but shade using dilFerent densities pi points, ff/lftfCTOTLi'Rir turns on in 
average Ol of Ihe points, created by QR'ing two random numbers, LIGRTTEXTURR aver egos 
1/4 of the points! obtained by AMJtng two random numbers. 

New shading pel ter ns consisting oF erbsilrp? y pictures tan be defined by using |he following 
primitive: 

M/iKEP/ITTERN <pctt+H-ivim*> ^wintteH'-nojiie* (Iff) 

the first argument is a name For Ihe new pattern. The second Is |fhs name OF a window,, 
■c onstruc ted! by the M A Elf 't iVWOIF command. This create; 1 new pat tern, which consists of I ha 
picture saved in Ihe window. The pattern name may Ihen be given as input la SlIATlfi. The effect 
will be to fill the dosed curve to be shaded with the picture speed led by the window. If area 
beyond the extent Of Lhe original picture is to he shaded, the picture will be repeated horijpnlally 
and vertically »$ many timos as is necessary to fill the area. 

Alternatively, a shading pattern may be constructed by the user directly as a Function. [This 
can result in faster shading than by using a pattern constructed by Jtf/IKEP^rTKfliVj although it’s 
more diflicylt lo write, especially Fo*- complex patterns.] A pattern I; a (unction Of two Integer 
ar^ufflionte, y and V coordinates of a word in the TV memory [a® lor Ihe inputs to TV, Bee Section 
17.??], it returns an integer, which indicates |he state fli 32 bits ol the screen, left justified, 


17.20 Invisible Mode 


When a program dopy both a consider sble an cun I □} graphics as welt as non-griphlc 
computation, >1 olten becomes convenient to bo abte to debug these component 5 separately. An 
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"invisible* mode makes it possible to debug the non -graphic parts of a program containing turtle 
esmtoundta, without incurring the Overhead et drawing on the screen. When the syslar is heavily 
loaded, coda run in ’‘invisible* made writ run much Fitter, allowing the user to run a procedure if ho 
is rut interested in the picture drawn, then return to Visible" mode ta debug the picture?, drawn by 
the p-rfigrarp Pi-tfures drawn in mvisibie mode are no: saved and returning to visible made requires 
that programs be re-e*eeuted to observe the picture drawn. 

f INVISIBLE 

Enters "invisible" mode. Arty primitive 1 hat would cause changes to pictures on (he screen? 
movement of the turtle, display ol saved pictures, pomls, etc, will net cause anything on the screen 
la change white running in invisible mode, Execution or procedures containing lurtle primitives will 
proceed much faster] this permits running Of procedures containing turtle primitives lor the purpose 
of debugging their nqn-g,Taphic behavior. 

VISIBLE 


Returns to Visible" mode. Turtle functions have Iheir mual effect, as well as I heir usual 
slowness. VISIBLE causes a Cf.ft/lfi.S'CflKKiV. 


E a ten a Luna 

One povi'tilr so Ur t a of extensions to the TV turtta package would be the inclusion of 
picture-saving capabilities simitar to the £,1f/IP command nl fhe ULOOQ turtle for the 330, Or 1o 
11 LOGO'S This would differ from the "windows" described above in that if would be a tower- 

level representation Of the picture in terms ot vectors tq be displayed, rather than an array Of 
points. Because the TV .terminals do not have hardware For display of vectors, necessitating the 
computation of points lying along a vector to draw it, redisplay oF a snap would be very nearly as 
time-consuming as re-executing the LOGO procedure which drew the picture. In contrast, redisplay 
of a window bypasses fhal rec-Ompul alien, and requires much less time to redisplay than the Original 
drawing procedure required. However, a vector representation does provide several advantages. If 
is less space-consuming for pictures which Occupy large portions of the- screen, but cOnlaih few 
vectors. ]( can he used mom easily with pictures for which a description in terms of rectangular 
portions Of the screen would be inconvenient;, for example, in irregularly shaped picture surrounded 
by drawings not fo be included in the saved picture, The window representation makes i( difficult to 
assign Independent names (b the saved, graphic oulpul of each of several programs if the pictures 
Overlap. Certain transformations such as rotations and scaling might be more easily performed on a 
vecfpr representation than on point arrays. 

An additional difficulty in providing a snap Facility in |he TV turtle similar to that possible 
with vector oriented displays would 5 arise in implsmein,ling. the ERASE SNAP command- II sever*! 
lines ell pass through a single point on the screen, the oOint musl not be l-urred Otf until all lines ere 
erased If one line Is erased via an Kff/ISK SNAE t and olher lines still pass through the point, the 
point must not ba lurned off. This requires Leaping track of how many hnos pass IhrOugh each pftirL 
Such information could be obtained Iron computing the ntefsection and overlap of vectors displayed 
whenever a vector 1$ drawn Of erased,. Or by taping a "reference count* For each point, 
incremented whenever a line passing through the point Is drawn, decremented when such * line ta 
erased. The “erases mode* of the TV turtle turns otf points ifong lines drawn regardless Of Iheir 
previous stale. Ttita makes il somewhat less convenient than ERASE SNAP for erasure of one of 
several overlapping pictures, although the *ame effect can be achieved by saving the previous 
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contents oi en are# im a window betore dra*ir$|. ever it. In some cases, S(jOR mode tan be used 
i rate ad, so t ha I the seme procedure can be used be I h In draw a picture, and to erase it, 

AnOlher alternative representation tat picture elements would be run length encoding. This 
would record the cGntenls- OF an area of the screen, as does the TV turtle ‘window". Each tine of the 
area is represented as » sequence of numbers, The numbers in the sequence alternately specify 
how many consecutive points are on. and how many consecutive paints are off. Li he the window 
Operation, this technique is capable ol he OR used wtth pictures containing shaded areas, which 
would not be possible with a repressntalien carsitt<n£ solely of vectors, Although it would require 
somewhat more compulation time to redisplay thin would a window, it -would not prove quite as 
$P*cq consuming for large and sparse pictures, ft is not depr whether the lime end space tradeoffs 
invOEved wbuld justify the use OF this representation. 

Each alternative representation Fpr pidure elements carries with it unique advantages and 
disadvantages, in terms of time and space efficiency, ease oF modi Fixation, etc. Rather than becoming 
committed to a single represent alien, a better goal is tn provide flexibility by making available many 
Options and allowing a user Or an intelligent system to chtKsse the representation according to the 
requirements of the application. 

An allornalive to the TV turtle's approach 10 pictures involving shading is to extend the 
LOGO concept of the turtle's 'pen" and ’crater" to a- "paintbrush''. A ’'paint* consisting of a particular 
shading pattern and a width For fhe paintbrush would be cK>sen by the user. When the turtle is 
moved after The execution or a fiRUSttBOWW command, the shading pattern is drawn in an area 
extending far the specified width on either side of the pith oi the turtle’s movement. I low ever, this 
method has the disadvantage that programs Ip shipe even very simple geometric figures c*h b**oma 
quite complicated. This mode might be useful however, it it were pdssibte la rove the brush under 
control of some analog input such as a light pen or mouse. Another possibility is to supply the 
system with specific knowledge about shading comman shapes, such as circles. 

Other extansions to the TV turtle could center an oraviding facilities oriented towards 
animation. LOGO as a graphics language is primarily ar-anted toward the display of italic pictures, it 
is weak in some OF the capabilities needed for convenient generation of movies. A more exlensiva 
vocabulary of transformations which can bo applied to pictures would be helpful. This could include 
roTatron end scaling <>F savetf pictures, three cfimensipnai coordinate Irtnsformahohs, as well as i 
convenient way nf incorporating user defined transformations. Some mean? qF explicitly controlling 
the time in which changes happen to the displayed picture should be provided. Extension of the 
control Structure to allow parallel elocution ol procedure would facilitate programming 
Independently changes to the picture whith should occur simultaneously. 

Another capability which the system should have is some provision lor analog input, such as 
from a lighl pen, joystick, tablet, dr mouse. This would allow the system to Obtain and manipulate 
freehand sketches. Convincing drawings of people or objects that would he difficult to construct 
from furl to programs c-Ould be readily input and then manipulated by programs. Objects On the 
screen could be selected by a user interactively using a rubber bend vector, which is often more 
convenient then, typing, especially for children. 


% 

17.22 iihp]eine»Ulii>n 

The POPL1 which controls the TV terminals maintains the user's screen in its memory, one 
bit per point. An ITS system call allows the lit merob-ry fq be mapped into bm address space ol • 
program running on the PDF LQ. An initialization routine written in LAP assembly language performs 
this system call,, and sots up an array header which convinces U£P that fh«s area of memory is really 
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the date lor a LI&P two-dimensional integer array. Thu array is accessible directly by the user who 
finds the supplied turtle primitives r*Pt Suited to his needs. All changes to the display stfHn aro 
perfdi'tnttl directly by LESP STVNEs, and Ihe remainder oF the display package it written entirely in 
USP- 


The following primitives arE probably not ol general IhtsrOsI, bul ere internal to tin TV 
turlle p ackjg.fi, and might conceivably be or use lo a user dejirirva nomtindard appheat ons. 

TV ^ffne^ ^wlumrr-w^^ 

This is Ihe array which holds thw user's TV hufFer. A call to TV returns b 36 bil fisad point 
number, which contains two 1& bil POP LI words, left justified. SJYJJflTs into Ihe array will e*U» 
the array and the user’s tcropn t» modiliad as described in Ihe discussion or BJt/JIF'JttEJIJK, 
be-ow, Any such ittlKt’E should keep the low order four bits of each word jero. The first Input 
counts number ol Fines from Ihe top, from {] to The se-tond selects t word On lbs Ime, left TP 
right, from 0 to 17 (for a total o! LB * 33 - 57& bits per ImeJ 

PR/W'mdi 1 

The POP I L has b Feature which enables any atlempl to wrile a word in the H's memory 
from the PDP1Q to result in a specified boolean lundiun ot the ward being written and the word 
previously there. DRAW MODE changes that specification according to ^mode^, which should be an 
inlager representing the mode chosen Irom the values of one of the fShowing alomsi /0JT. A 1 Off, 
ANDC r SAME r 0)»P, EQV, SKTQ. SETZ, $ET. For oscmplt, STORE TV 9 4 i6 will turn Ihe low 
order bil OF the second 16 bit word of the IV bufier On it JfJR mode is in effect, oJf if ANDC mOcto 
is in effect, and complement whatever is (here if In 10fl mode- DRAWMODE returns tho number 
describing the mode previously in eFIect. 

.DRAW MODE 

A global variabla containing the CUrrsnt mode number as set by the last call to 
DRAW MODE. 
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